Sets or gets the string value of a cookie.
HRESULT IHTMLDocument2::get_cookie(BSTR *p);HRESULT IHTMLDocument2::put_cookie(BSTR v);
- Pointer to a variable of type BSTR that receives the name=value; pairs, plus any of the values listed in Possible Values.
- BSTR that specifies the name=value; pairs, plus any of the values listed in Possible Values.
secure; If you set a cookie as
secure;, the stored cookie information can be accessed only from Secure Hypertext Transfer Protocol (HTTPS).
expires=date; If you set no expiration date on a cookie, it expires when the browser closes. If you set an expiration date, the cookie is saved across browser sessions. If you set an expiration date in the past, the cookie is deleted. Use Greenwich Mean Time (GMT) format to specify the date. domain=domainname; If you set the domain of the cookie, documents on a domain made up of more than one server can share cookie information. path=path; If you set a path for the cookie, the current document can share cookie information with other documents within the same domain—that is, if the path is set to /thispathname, all documents in /thispathname and all documents in subfolders of /thispathname can access the same cookie information.
Returns S_OK if successful, or an error value otherwise.
A cookie is a small piece of information. Each cookie is stored in a name=value pair called a crumb—that is, if the cookie name is "id" and you want to save the id value as "this," the cookie is saved as id=this. You can store up to a maxium of 50 name=value pairs in a cookie; the cookie is always returned as a string of all the cookies that apply to the document. This means that you must parse the string returned to find the values of individual cookies.
Cookies accumulate each time the property is set. Once the maxium pair limit is reached, subsequent set will push older name=value pair off in favor of the new name=value pair.