AuthzGetInformationFromContext function

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

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

See also

Basic Access Control Functions

AUTHZ_CONTEXT_INFORMATION_CLASS

AUTHZ_SECURITY_ATTRIBUTES_INFORMATION

TOKEN_GROUPS