Funzione AuthzInitializeContextFromToken (authz.h)

Articolo
02/26/2024

La funzione AuthzInitializeContextFromToken inizializza un contesto di autorizzazione client da un token kernel. Il token del kernel deve essere stato aperto per TOKEN_QUERY.

A partire da Windows Server 2012 e Windows 8, questa funzione può anche copiare gruppi di dispositivi, attestazioni utente e attestazioni del dispositivo.

Sintassi

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
);

Parametri

[in] Flags

Riservato per utilizzi futuri.

[in] TokenHandle

Handle per il token client usato per inizializzare il parametro pAuthzClientContext . Il token deve essere stato aperto con accesso TOKEN_QUERY.

[in] hAuthzResourceManager

Handle per resource manager che ha creato questo contesto client. Questo handle viene archiviato nella struttura del contesto client.

[in, optional] pExpirationTime

Data e ora di scadenza del token. Se non viene passato alcun valore, il token non scade mai. L'ora di scadenza non è attualmente applicata.

[in] Identifier

Identificatore specifico di Resource Manager. Questo parametro non è attualmente utilizzato.

[in, optional] DynamicGroupArgs

Puntatore ai parametri da passare alla funzione di callback che calcola i gruppi dinamici.

[out] phAuthzClientContext

Puntatore all'handle AuthzClientContext restituito. Chiamare AuthzFreeContext al termine del contesto client.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE.

Se la funzione ha esito negativo, restituisce FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Questa funzione chiama la funzione di callback AuthzComputeGroupsCallback per aggiungere identificatori di sicurezza al contesto appena creato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	authz.h
Libreria	Authz.lib
DLL	Authz.dll
Componente ridistribuibile	Windows Server 2003 Administration Tools Pack in Windows XP

Vedi anche

AuthzFreeContext

Funzioni Controllo di accesso di base

Condividi tramite