IInternetSecurityManager::GetSecurityId (Windows Embedded CE 6.0)

1/6/2010

This method retrieves the security identification of the specified URL.

Syntax

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

pbSecurityId
[out] Address of a buffer that specifies 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] Address of an 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 — is used as the security identifier.

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.

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.