Méthode SWbemPrivilegeSet.Add

La méthode Add de l’objet SWbemPrivilegeSet ajoute un objet SWbemPrivilege à la collection SWbemPrivilegeSet. Si un privilège portant le même nom existe déjà dans la collection, il sera remplacé.

Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API de script.

Syntaxe

objPrivilege = .Add( _
  ByVal iPrivilege, _
  [ ByVal bIsEnabled ] _
)

Paramètres

iPrivilege

Obligatoire. Il s’agit de l’une des constantes WMI du groupe WbemPrivilegeEnum. Ces constantes sont essentiellement des entiers qui représentent des privilèges spécifiques. Par exemple, pour ajouter le privilège qui vous permet d’arrêter un système informatique, utilisez la constante wbemPrivilegeShutdown . Dans un script, vous devez utiliser l’équivalent numérique de 23 (0x17). Pour obtenir la liste complète de ces chaînes et des constantes WMI associées, consultez Constantes de privilèges.

bIsEnabled [facultatif]

Valeur booléenne qui active ou désactive ce privilège. La valeur par défaut est TRUE.

Valeur retournée

Si elle réussit, cette méthode retourne un objet SWbemPrivilege qui représente le nouveau privilège. Sinon, un objet de valeur nulle est retourné.

Codes d’erreur

Au terme de l’exécution de la méthode AddAsString, l’objet Err peut contenir un code d’erreur de la liste suivante.

wbemErrFailed - 2147749889 (0x80041001)

Erreur non spécifiée.

Exemples

Un exemple de code utilisant cette méthode est également décrit dans la rubrique SWbemPrivilegeSet.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	Wbemdisp.h
Bibliothèque de types	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemPrivilegeSet
IID	IID_ISWbemPrivilegeSet

Voir aussi

SWbemPrivilegeSet

Exécution d’opérations privilégiées

Exécution d’opérations privilégiées à l’aide de VBScript

SWbemPrivilegeSet.AddAsString

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

Constantes de privilèges