Funzione AuthzInitializeContextFromSid (authz.h)

La funzione AuthzInitializeContextFromSid crea un contesto client in modalità utente da un identificatore di sicurezza utente (SID). I SID di dominio recuperano gli attributi del gruppo di token da Active Directory.

Sintassi

AUTHZAPI BOOL AuthzInitializeContextFromSid(
  [in]           DWORD                         Flags,
  [in]           PSID                          UserSid,
  [in, optional] AUTHZ_RESOURCE_MANAGER_HANDLE hAuthzResourceManager,
  [in]           PLARGE_INTEGER                pExpirationTime,
  [in]           LUID                          Identifier,
  [in, optional] PVOID                         DynamicGroupArgs,
  [out]          PAUTHZ_CLIENT_CONTEXT_HANDLE  phAuthzClientContext
);

Parametri

[in] Flags

I flag seguenti sono definiti.

A partire da Windows 8 e Windows Server 2012, quando si chiama questa funzione in un handle di contesto remoto, i 16 bit superiori devono essere zero.

[in] UserSid

SID dell'utente per cui verrà creato un contesto client. Questo deve essere un account utente o computer valido a meno che non venga usato il flag di AUTHZ_SKIP_TOKEN_GROUPS.

[in, optional] hAuthzResourceManager

Handle per gestione risorse che crea questo contesto client. Questo handle viene archiviato nella struttura del contesto client.

A partire da Windows 8 e Windows Server 2012, resource manager può essere locale o remoto e viene ottenuto chiamando la funzione AuthzInitializeRemoteResourceManager.

[in] 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 del gestore risorse. Questo parametro non viene attualmente usato.

[in, optional] DynamicGroupArgs

Puntatore ai parametri da passare alla funzione di callback che calcola i gruppi dinamici. Questo parametro può essere NULL se non vengono passati parametri dinamici alla funzione di callback.

A partire da Windows 8 e Windows Server 2012, questo parametro deve essere NULL se gestione risorse è remoto. In caso contrario, ERROR_NOT_SUPPORTED verrà impostato.

[out] phAuthzClientContext

Puntatore all'handle al contesto client creato dalla funzione AuthzInitializeContextFromSid . Al termine dell'uso dell'handle, liberarlo chiamando la funzione AuthzFreeContext .

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

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

Commenti

Se possibile, chiamare la funzione AuthzInitializeContextFromToken anziché AuthzInitializeContextFromSid. AuthzInitializeContextFromSid tenta di recuperare le informazioni disponibili in un token di accesso con il client effettivamente connesso. Un token di accesso effettivo fornisce altre informazioni, ad esempio il tipo di accesso e le proprietà di accesso e riflette il comportamento del pacchetto di autenticazione usato per l'accesso. Il contesto client creato da AuthzInitializeContextFromToken usa un token di accesso e il contesto client risultante è più completo e accurato di un contesto client creato da AuthzInitializeContextFromSid.

Questa funzione risolve solo i SID utente validi.

Windows XP: Questa funzione risolve le appartenenze ai gruppi per i SID utente e gruppi validi (a meno che non venga usato il flag di AUTHZ_SKIP_TOKEN_GROUPS). Il supporto per la risoluzione delle appartenenze dei SID di gruppo può essere modificato o non disponibile nelle versioni successive.

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

Requisiti

Vedi anche

Consenti l'accesso anonimo

AuthzFreeContext

Funzioni di base Controllo di accesso