SWbemPrivilegeSet.AddAsString, méthode
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 |
|
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID_SWbemPrivilegeSet |
| IID |
IID_ISWbemPrivilegeSet |