IInternetSecurityManager::GetSecurityId Method

---

Retrieves the security identification of the specified URL.

Syntax

HRESULT GetSecurityId(
    LPCWSTR pwszUrl,
    BYTE *pbSecurityId,
    DWORD *pcbSecurityId,
    DWORD dwReserved
);

Parameters

pwszUrl

[in] Address of a string value that contains the URL.

pbSecurityId

[out] Address of a buffer that contains the scheme, domain name, and zone associated with the URL.

pcbSecurityId

[in, out] Address of an unsigned long integer value that specifies the size of the buffer being passed in.

dwReserved

[in] Unsigned long integer that specifies 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 identifier.

Return Value

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.

Remarks

If successful, pbSecurityId contains the scheme, domain, and zone information in the following format:

<scheme>:<domain>+<zone>

The pcbSecurityID parameter contains the actual size of the data stored in the buffer.