Función AuthzInitializeContextFromToken (authz.h)

La función AuthzInitializeContextFromToken inicializa un contexto de autorización de cliente a partir de un token de kernel. El token de kernel debe haberse abierto para TOKEN_QUERY.

A partir de Windows Server 2012 y Windows 8, esta función también puede copiar grupos de dispositivos, notificaciones de usuario y notificaciones de dispositivo.

Sintaxis

AUTHZAPI BOOL AuthzInitializeContextFromToken(
  [in]           DWORD                         Flags,
  [in]           HANDLE                        TokenHandle,
  [in]           AUTHZ_RESOURCE_MANAGER_HANDLE hAuthzResourceManager,
  [in, optional] PLARGE_INTEGER                pExpirationTime,
  [in]           LUID                          Identifier,
  [in, optional] PVOID                         DynamicGroupArgs,
  [out]          PAUTHZ_CLIENT_CONTEXT_HANDLE  phAuthzClientContext
);

Parámetros

[in] Flags

Reservado para uso futuro.

[in] TokenHandle

Identificador del token de cliente usado para inicializar el parámetro pAuthzClientContext . El token debe haberse abierto con TOKEN_QUERY acceso.

[in] hAuthzResourceManager

Identificador del administrador de recursos que creó este contexto de cliente. Este identificador se almacena en la estructura de contexto de cliente.

[in, optional] pExpirationTime

Fecha y hora de expiración del token. Si no se pasa ningún valor, el token nunca expira. La hora de expiración no se aplica actualmente.

[in] Identifier

Identificador específico del administrador de recursos. Este parámetro no se usa actualmente.

[in, optional] DynamicGroupArgs

Puntero a parámetros que se van a pasar a la función de devolución de llamada que calcula grupos dinámicos.

[out] phAuthzClientContext

Puntero al identificador AuthzClientContext devuelto. Llame a AuthzFreeContext cuando haya terminado con el contexto del cliente.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Esta función llama a la función de devolución de llamada AuthzComputeGroupsCallback para agregar identificadores de seguridad al contexto recién creado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	authz.h
Library	Authz.lib
Archivo DLL	Authz.dll
Redistribuible	Paquete de herramientas de administración de Windows Server 2003 en Windows XP

Consulte también

AuthzFreeContext

Funciones básicas de Access Control