Funzione AuthzModifySids (authz.h)

Articolo
02/26/2024

La funzione AuthzModifySids aggiunge, elimina o modifica i gruppi di utenti e dispositivi nel contesto client Authz.

Sintassi

AUTHZAPI BOOL AuthzModifySids(
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE     hAuthzClientContext,
  [in]           AUTHZ_CONTEXT_INFORMATION_CLASS SidClass,
  [in]           PAUTHZ_SID_OPERATION            pSidOperations,
  [in, optional] PTOKEN_GROUPS                   pSids
);

Parametri

[in] hAuthzClientContext

Handle per il contesto client da modificare.

[in] SidClass

Tipo di informazioni da modificare. Il chiamante può specificare AuthzContextInfoGroupsSids, AuthzContextInfoRestrictedSids o AuthzContextInfoDeviceSids.

[in] pSidOperations

Puntatore a una matrice di AUTHZ_SID_OPERATION valori di enumerazione che specificano le modifiche del gruppo da apportare.

[in, optional] pSids

Puntatore a una struttura TOKEN_GROUPS che specifica i gruppi da modificare.

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

L'enumerazione AUTHZ_SID_OPERATION deve avere un solo elemento se il valore di tale elemento è AUTHZ_SID_OPERATION_REPLACE_ALL. In caso contrario, la matrice ha lo stesso numero di elementi del PTOKEN_GROUPS corrispondente.

Quando si vuole usare AuthzModifySids per eliminare, i SID vengono confrontati ma non i flag SID. Se non viene trovato alcun SID corrispondente, non vengono apportate modifiche e la chiamata non riesce.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	authz.h
Libreria	Authz.lib
DLL	Authz.dll

Condividi tramite