Partager via


IAzScope ::AddPropertyItem, méthode (azroles.h)

La méthode AddPropertyItem ajoute le principal spécifié à la liste spécifiée de principaux.

Syntaxe

HRESULT AddPropertyItem(
  [in]           LONG    lPropId,
  [in]           VARIANT varProp,
  [in, optional] VARIANT varReserved
);

Paramètres

[in] lPropId

ID de propriété de la liste des principaux auxquels ajouter le principal spécifié par le paramètre varProp . Le tableau suivant répertorie les valeurs possibles.

Value Signification
AZ_PROP_POLICY_ADMINS
Peut également être ajouté à l’aide de la méthode AddPolicyAdministrator
AZ_PROP_POLICY_ADMINS_NAME
Peut également être ajouté à l’aide de la méthode AddPolicyAdministratorName
AZ_PROP_POLICY_READERS
Peut également être ajouté à l’aide de la méthode AddPolicyReader
AZ_PROP_POLICY_READERS_NAME
Peut également être ajouté à l’aide de la méthode AddPolicyReaderName

[in] varProp

Principal à ajouter à la liste des principaux spécifiés par le paramètre lPropId .

La variante doit être une variante BSTR .

Si AZ_PROP_POLICY_ADMINS ou AZ_PROP_POLICY_READERS est spécifié pour le paramètre lPropId , la chaîne est le texte de l’identificateur de sécurité (SID) du compte Windows à ajouter à la liste. Si AZ_PROP_POLICY_ADMINS_NAME ou AZ_PROP_POLICY_READERS_NAME est spécifié pour le paramètre lPropId , la chaîne est le nom du compte à ajouter à la liste. Le nom du compte peut être au format de nom d’utilisateur principal (UPN) (par exemple, «someone@example.com ») ou au format « ExampleDomain\UserName ».

[in, optional] varReserved

Réservé pour un usage futur.

Valeur retournée

La valeur de retour est un HRESULT. La valeur S_OK indique la réussite. Toute autre valeur indique que l’opération a échoué.

Remarques

Vous devez appeler la méthode Submit pour conserver toutes les modifications apportées par cette méthode.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête azroles.h
Bibliothèque Azroles.lib
DLL Azroles.dll
Composant redistribuable Windows Server 2003 Administration Tools Pack sur Windows XP