AuthzGetInformationFromContext function (authz.h)
The AuthzGetInformationFromContext function returns information about an Authz context.
Starting with Windows Server 2012 and Windows 8, device groups are returned as a TOKEN_GROUPS structure. User and device claims are returned as an AUTHZ_SECURITY_ATTRIBUTES_INFORMATION structure.
Syntax
AUTHZAPI BOOL AuthzGetInformationFromContext(
[in] AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext,
[in] AUTHZ_CONTEXT_INFORMATION_CLASS InfoClass,
[in] DWORD BufferSize,
[out] PDWORD pSizeRequired,
[out] PVOID Buffer
);
Parameters
[in] hAuthzClientContext
A handle to the context.
[in] InfoClass
A value of the AUTHZ_CONTEXT_INFORMATION_CLASS enumeration that indicates the type of information to be returned.
[in] BufferSize
Size of the buffer passed.
[out] pSizeRequired
A pointer to a DWORD of the buffer size required for returning the structure.
[out] Buffer
A pointer to memory that can receive the information. The structure returned depends on the information requested in the InfoClass parameter.
Return value
If the function succeeds, it returns TRUE.
If the function fails, it returns FALSE. To get extended error information, call GetLastError.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | authz.h |
| Library | Authz.lib |
| DLL | Authz.dll |
| Redistributable | Windows Server 2003 Administration Tools Pack on Windows XP |
See also
AUTHZ_CONTEXT_INFORMATION_CLASS
AUTHZ_SECURITY_ATTRIBUTES_INFORMATION