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. |
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 pwszUrlis not a valid URL.
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 |
Internal Server Error
The server encountered an internal error or misconfiguration and was unable to complete your request.
Please contact the server administrator at webmaster@systemmanager.forsenergy.ru to inform them of the time this error occurred, and the actions you performed just before this error.
More information about this error may be available in the server error log.
Additionally, a 500 Internal Server Error error was encountered while trying to use an ErrorDocument to handle the request.