IInternetSecurityManager::GetSecurityId

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method retrieves the security identification of the specified URL.

Syntax

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

Parameters

• pwszUrl
  [in] Address of a string value that specifies the URL.

• 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.

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.

Requirements