SWbemServices. obten, méthode
La méthode d’extraction de l’objet SWbemServices récupère un objet, qui est soit une définition de classe, soit une instance, en fonction du chemin d’accès de l’objet. Cette méthode récupère uniquement les objets de l’espace de noms associé à l’objet SWbemServices actif.
La méthode est appelée en mode synchrone. Pour plus d’informations, consultez appel d’une méthode.
Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.
Syntaxe
objWbemObject = .Get( _
[ ByVal strObjectPath ], _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ] _
)
Paramètres
-
strObjectPath [ facultatif]
-
Chaîne qui contient le chemin d’accès de l’objet à récupérer. Si cette valeur est vide, l’objet vide retourné peut devenir une nouvelle classe. Pour plus d’informations, consultez Description de l’emplacement d’un objet WMI.
-
IFlags [ facultatif]
-
Entier qui détermine le comportement de la requête. Ce paramètre peut accepter les valeurs suivantes.
-
wbemFlagUseAmendedQualifiers * * * * (131072 (0x20000))
-
Fait en sorte que WMI retourne des données de modification de classe avec la définition de classe de base. Pour plus d’informations sur les qualificateurs modifiés, consultez localisation des informations de classe WMI.
objWbemNamedValueSet [ facultatif]
En général, ce n’est pas défini. Dans le cas contraire, il s’agit d’un objet SWbemNamedValueSet dont les éléments représentent les informations de contexte qui peuvent être utilisées par le fournisseur qui traite la requête. Un fournisseur qui prend en charge ou requiert ces informations doit documenter les noms de valeur reconnus, le type de données de la valeur, les valeurs autorisées et la sémantique.
Valeur de retour
En cas de réussite, cette méthode retourne un objet SWbemObject qui représente l’objet demandé.
Codes d’erreur
À la fin de la méthode d' extraction , l’objet Err peut contenir l’un des codes d’erreur répertoriés dans la liste suivante.
-
wbemErrAccessDenied -2147749891 (0x80041003)
-
L’utilisateur actuel n’a pas l’autorisation d’accéder à l’objet.
-
wbemErrFailed -2147749889 (0x80041001)
-
Erreur non spécifiée.
-
wbemErrInvalidParameter -2147749896 (0x80041008)
-
Un paramètre spécifié n’est pas valide.
-
wbemErrInvalidObjectPath -2147749946 (0x8004103A)
-
Le chemin d’accès spécifié n’est pas valide.
-
wbemErrNotFound -2147749890 (0x80041002)
-
L’objet demandé est introuvable.
-
wbemErrOutOfMemory -2147749894 (0x80041006)
-
Mémoire insuffisante pour terminer l’opération.
Notes
Contrairement aux méthodes ExecQuery et InstancesOf , la méthode obtenir retourne toujours un SWbemObject représentant une instance spécifique d’une ressource managée par WMI. Pour obtenir une instance spécifique d’une ressource managée WMI à l’aide de la méthode obtenir, vous devez indiquer à l’instance de récupérer l’instance en passant la méthode au chemin d’accès de l’objet, comme indiqué dans le script suivant.
strComputer = "."
Set objSWbemServices = GetObject("winmgmts:\\" & strComputer & "\root\cimv2")
Set objSWbemObject = objSWbemServices.Get("Win32_Service.Name='Messenger'")
Wscript.Echo "Name: " & objSWbemObject.Name & vbCrLf & _
"Display Name: " & objSWbemObject.DisplayName & vbCrLf & _
"Start Mode: " & objSWbemObject.StartMode & vbCrLf & _
"State: " & objSWbemObject.State
Vous pouvez utiliser cette méthode pour obtenir des objets Singleton , tels que _ _ CIMOMIdentification, qui contient des informations de version sur l’installation WMI en cours d’exécution.
Vous pouvez examiner le référentiel à l’aide d’un outil d’affichage tel que CIM Studio pour vérifier que la nouvelle classe et l’instance s’affichent. Pour obtenir un exemple de suppression d’une classe et d’une instance du référentiel, consultez SWbemServices. Delete ou SWbemObject. _ Delete.
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 _ SWbemServices |
| IID |
IID _ ISWbemServices |