CResponse::setExpiresAbsolute

The CResponse::setExpiresAbsolute function sets the value of the ExpiresAbsolute property.

int setExpiresAbsolute(
chchar * expiresAbsolute // containing the new ExpiresAbsolute value
);

Return Type

int
Upon successful completion, zero is returned. Otherwise, a value of non-zero is returned.

Parameters

expiresAbsolute
A string containing the new ExpiresAbsolute value.

Remarks

This function sets the value of the ExpiresAbsolute property of the object. If the user returns to the same page before the set date and time, the cached version is displayed. If this property is set more than once on a page, the earliest expiration date or time is used. If the expiration date and time is not set before this function is called, NULL is returned.

The date string is formatted as:

 Wdy, DD-Mon-YYYY HH:MM:SS GMT

This is based on RFC 822, RFC 850, RFC 1036, and RFC 1123, with the variations that the only legal time zone is GMT (Greenwich Mean Time) and the separators between the elements of the date must be dashes.

The CResponse::getExpiresAbsolute function can retrieve the ExpiresAbsolute property of the object