Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method retrieves the security identification of the host.

Syntax 

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

Parameters

pbSecurityId

[out] Address of a buffer that specifies the scheme, domain name, and zone of the host.

pcbSecurityId

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

dwReserved

[in] Reserved. Must be set to NULL.

Return Value

Returns S_OK if successful or E_INVALIDARG if the buffer is set to NULL.

Remarks

If successful, pbSecurityIdcontains the scheme, domain, and zone information in the following format.

Copy Code 
<scheme>:<domain>+<zone>

The pcbSecurityIdparameter 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