Share via


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

Header urlmon.h, urlmon.idl
Library urlmon.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later