AuthzGetInformationFromContext function
Applies to: desktop apps only
The AuthzGetInformationFromContext function returns information about an Authz context.
Starting with Windows Server 8 Beta and Windows 8 Consumer Preview, device groups are returned as a TOKEN_GROUPS structure. User and device claims are returned as an AUTHZ_SECURITY_ATTRIBUTES_INFORMATION structure.
Syntax
BOOL WINAPI AuthzGetInformationFromContext( __in AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext, __in AUTHZ_CONTEXT_INFORMATION_CLASS InfoClass, __in DWORD BufferSize, __out PDWORD pSizeRequired, __out PVOID Buffer );
Parameters
- hAuthzClientContext [in]
-
A handle to the context.
- InfoClass [in]
-
A value of the AUTHZ_CONTEXT_INFORMATION_CLASS enumeration that indicates the type of information to be returned.
- BufferSize [in]
-
Size of the buffer passed.
- pSizeRequired [out]
-
A pointer to a DWORD of the buffer size required for returning the structure.
- Buffer [out]
-
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
|
Minimum supported client | Windows XP |
|---|---|
|
Minimum supported server | Windows Server 2003 |
|
Redistributable | Windows Server 2003 Administration Tools Pack on Windows XP |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Basic Access Control Functions
- AUTHZ_CONTEXT_INFORMATION_CLASS
- AUTHZ_SECURITY_ATTRIBUTES_INFORMATION
- TOKEN_GROUPS
Send comments about this topic to Microsoft
Build date: 3/7/2012
