Función AuthzInitializeContextFromAuthzContext (authz.h)

La función AuthzInitializeContextFromAuthzContext crea un nuevo contexto de cliente basado en un contexto de cliente existente.

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

Sintaxis

AUTHZAPI BOOL AuthzInitializeContextFromAuthzContext(
  [in]           DWORD                        Flags,
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE  hAuthzClientContext,
  [in, optional] PLARGE_INTEGER               pExpirationTime,
  [in]           LUID                         Identifier,
  [in]           PVOID                        DynamicGroupArgs,
  [out]          PAUTHZ_CLIENT_CONTEXT_HANDLE phNewAuthzClientContext
);

Parámetros

[in] Flags

Reservado para uso futuro.

[in] hAuthzClientContext

Identificador de un contexto de cliente existente.

[in, optional] pExpirationTime

Establece el límite de tiempo durante cuánto tiempo es válido la estructura de contexto devuelta. 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.

[in] DynamicGroupArgs

Puntero a parámetros que se van a pasar a la función de devolución de llamada que calcula grupos dinámicos. Si el valor es NULL, no se llama a la función de devolución de llamada.

[out] phNewAuthzClientContext

Puntero al identificador de AUTHZ_CLIENT_CONTEXT_HANDLE duplicado. Cuando haya terminado de usar el identificador, suelte mediante una llamada a la función AuthzFreeContext .

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

AUTHZ_ACCESS_REPLY

Funciones básicas de Access Control