Méthode SWbemObject.GetObjectText_

Article
07/03/2023

La méthode GetObjectText_ de l'objet SWbemObject renvoie un rendu textuel de l'objet. Cet objet peut être utilisé pour afficher le contenu d’un objet. Actuellement, seule la syntaxe MOF est prise en charge en tant que format de sortie. Notez que le texte MOF renvoyé ne contient pas toutes les informations relatives à l'objet ; le texte MOF ne contient que suffisamment d'informations pour que le compilateur MOF puisse recréer l'objet d'origine. Pour instance, il n’existe aucune information sur les qualificateurs propagés ou les propriétés de classe parente.

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

Syntaxe

strMofText = .GetObjectText_( _
  [ ByVal iFlags ] _
)

Paramètres

iFlags [in, facultatif]: Réservé et doit être défini sur 0 (zéro) si spécifié.

Valeur retournée

Si elle réussit, cette méthode retourne une chaîne qui contient le texte de sortie.

Codes d’erreur

Une fois la méthode PutAsync terminée, l’objet Err peut contenir l’un des codes d’erreur de la liste suivante.

wbemErrFailed - 2147749889 (0x80041001): Erreur non spécifiée.
wbemErrInvalidParameter - 2147749896 (0x80041008): Un paramètre non valide a été spécifié.
wbemErrOutOfMemory - 2147749894 (0x80041006): La mémoire disponible est insuffisante pour terminer cette opération.

Exemples

Le code suivant, extrait de l’exemple de code List the Definition of a WMI Class in MOF Format VBScript dans TechNet Gallery, récupère et affiche la représentation textuelle d’une définition de classe WMI dans la syntaxe MOF (Managed Object Format).

strComputer = "." 
strNameSpace = "root\cimv2" 
strClass = "Win32_Service" 
  
Const wbemFlagUseAmendedQualifiers = &h20000 
  
Set objClass = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & _  
    strComputer & "\" & strNameSpace) 
 
Set objClass = objWMIService.Get(strClass, wbemFlagUseAmendedQualifiers) 
strMOF = objClass.GetObjectText_ 
  
WScript.Echo strMOF

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_SWbemObject
IID	IID_ISWbemObject

Partager via