AuthzModifySids, fonction (authz.h)

Article
02/26/2024

La fonction AuthzModifySids ajoute, supprime ou modifie des groupes d’utilisateurs et d’appareils dans le contexte du client Authz.

Syntaxe

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

Paramètres

[in] hAuthzClientContext

Handle du contexte client à modifier.

[in] SidClass

Type d’informations à modifier. L’appelant peut spécifier AuthzContextInfoGroupsSids, AuthzContextInfoRestrictedSids ou AuthzContextInfoDeviceSids.

[in] pSidOperations

Pointeur vers un tableau de valeurs d’énumération AUTHZ_SID_OPERATION qui spécifient les modifications de groupe à apporter.

[in, optional] pSids

Pointeur vers une structure TOKEN_GROUPS qui spécifie les groupes à modifier.

Valeur retournée

Si la fonction réussit, elle retourne TRUE.

Si la fonction échoue, elle retourne FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

L’énumération AUTHZ_SID_OPERATION ne doit avoir qu’un seul élément si la valeur de cet élément est AUTHZ_SID_OPERATION_REPLACE_ALL. Sinon, le tableau a le même nombre d’éléments que le PTOKEN_GROUPS correspondant.

Lorsque vous souhaitez utiliser AuthzModifySids pour supprimer, les SID sont mis en correspondance, mais pas les indicateurs SID. Si aucun SID correspondant n’est trouvé, aucune modification n’est effectuée et l’appel échoue.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	authz.h
Bibliothèque	Authz.lib
DLL	Authz.dll

Partager via