SWbemPrivilegeSet.AddAsString, méthode

Article
07/03/2023

Vous pouvez utiliser la méthode AddAsString de l’objet SWbemPrivilegeSet pour ajouter un privilège à une collection SWbemPrivilegeSet à l’aide d’une chaîne de privilège. Utilisez cette méthode pour ajouter un privilège ou activer un privilège pour des objets SWbemSecurity. Consultez Exécution d’opérations privilégiées à l’aide de VBScript.

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

Syntaxe

objPrivilege = .AddAsString( _
  ByVal strPrivilege, _
  [ ByVal bIsEnabled ] _
)

Paramètres

strPrivilege: Obligatoire. Une des chaînes de privilège. Pour obtenir la liste complète de ces chaînes et des constantes WMI associées, consultez Constantes de privilèges. Chaque chaîne de privilège représente un privilège spécifique. Par exemple, pour ajouter le privilège permettant d’arrêter un système informatique, utilisez la chaîne SeShutdownPrivilege.
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 null est retourné.

Codes d’erreur

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

wbemErrFailed - 2147749889 (0x80041001): Erreur non spécifiée.

Exemples

L’exemple de code VBScript suivant crée un port pour un serveur d’impression d’impression avec Win32_TCPIPPrinterPort. SeLoadDriverPrivilege est obligatoire pour cette opération. Consultez Exécution d’opérations privilégiées.

Set objWMIService = GetObject("Winmgmts:")
objWMIService.Security_.Privileges. _
    AddAsString "SeLoadDriverPrivilege", True
Set objNewPort = objWMIService.Get _
    ("Win32_TCPIPPrinterPort").SpawnInstance_
objNewPort.Name = "IP_111.222.111.11"
objNewPort.Protocol = 1
objNewPort.HostAddress = "111.222.111.11"
objNewPort.PortNumber = "9999"
objNewPort.SNMPEnabled = False
objNewPort.Put_

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
SWbemPrivilegeSet.Add
SWbemPrivilegeSet.Remove
WbemPrivilegeEnum
Constantes de privilèges
Exécution d’opérations privilégiées
Exécution d’opérations privilégiées à l’aide de VBScript

Partager via