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
Wbemdisp. h
Bibliothèque de types
Wbemdisp. tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemServices
IID
IID _ ISWbemServices

Voir aussi

M

M