doReadRequest method
[This documentation is preliminary and is subject to change.]
Obsolete. Performs all requests located in the read-requests queue.
This method is not supported for Metro style apps using JavaScript.
Syntax
HRESULT retVal = object.doReadRequest(usage, fname, domain, path, expire, reserved);
Standards information
There are no standards that apply here.
Parameters
usage [in]
Type: VARIANT
VARIANT of type VT_I4 that specifies the code that notifies the user of the type of access requested. This usage code should be one of the following 13 codes defined by the Internet Privacy Working Group (IPWG).
0
Used for system administration.
1
Used for research and product development.
2
Used for completion and support of the current transaction.
3
Used to customize the content and design of a site.
4
Used to improve the content of a site that includes advertisements.
5
Used for notifying visitors about updates to the site.
6
Used for contacting visitors for marketing of services or products.
7
Used for linking other collected information.
8
Used by a site for other purposes.
9
Disclosed to others for customization or improvement of the content and design of the site.
10
Disclosed to others, who may contact the user, for marketing of services or products.
11
Disclosed to others, who may contact the user, for marketing of services or products. The user can ask a site not to do this.
12
Disclosed to others for any other purpose.
fname [in, optional]
Type: VARIANT
VARIANT of type VT_BSTR that specifies the display name of the party requesting access to private information. For security reasons, it is not sufficient for the user agent to show this display name to the user. In addition to display name, the user agent must display the URL that originates the script requesting profile access. If this script originates from a secure connection (for example, SSL), the Web author can use the SSL certificate to reliably identify the party requesting access.
domain [in, optional]
Type: VARIANT
VARIANT of type VT_BSTR that specifies the pages that the user's choice will apply to in addition to the current page. The specification follows the cookie standard. See RFC2109: HTTP State Management Mechanism.
path [in, optional]
Type: VARIANT
VARIANT of type VT_BSTR that specifies the path to the domain server requesting access. When expire is set, the path is saved with the requested attributes.
expire [in, optional]
Type: VARIANT
VARIANT that specifies the amount of time the site has requested access to these attributes. This is currently ignored by Internet Explorer.
reserved [in, optional]
Type: VARIANT
This parameter is reserved.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
If the site does not have read access, the user is prompted with a list of requested attributes and can choose to allow or deny access.
As of Windows Internet Explorer 7, this method is obsolete and should not be used.
See also
Reference
IHTMLOpsProfile::addReadRequest
Build date: 6/12/2012