IInternetSecurityManager::GetSecurityId


		Contents Index Topic Contents
	Previous Topic: IInternetHostSecurityManager::QueryCustomPolicy Next Topic: IInternetSecurityManager::GetSecuritySite

IInternetSecurityManager::GetSecurityId
HRESULT GetSecurityId(
    [in] LPCWSTR pwszUrl,
    [out] BYTE *pbSecurityId,
    [in, out] DWORD *pcbSecurityId,
    [in] DWORD dwReserved
);
Retrieves the security identification of the given URL.
Returns S_OK if successful, or E_INVALIDARG if the buffer is set to NULL or the string passed in to pwszUrl is not a valid URL.

pwszUrl
String value that contains the URL.
pbSecurityId
Address of a buffer that contains the scheme, domain name, and zone associated with the URL.
pcbSecurityId
Address of a double-word value containing the size of the buffer being passed in.
dwReserved
Unsigned long integer that indicates the domain to use. If set to zero, the full domain name is used. Otherwise, a string value containing a suffix to the domain name can be specified. This larger domain name, the full domain name combined with the suffix, will be used as the security ID.

If successful, pbSecurityId contains the scheme, domain, and zone information in the following format:
<scheme>:<domain>+<zone>
And pcbSecurityID will contain the actual size of the data stored in the buffer.

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.