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 |