Método SWbemObject.GetObjectText_

Artigo
06/29/2023

O método GetObjectText_ do objeto SWbemObject retorna uma renderização textual do objeto. Esse objeto pode ser usado para exibir o conteúdo de um objeto. Atualmente, somente a sintaxe MOF tem suporte como um formato de saída. Observe que o texto MOF retornado não contém todas as informações sobre o objeto; ele contém apenas informações suficientes para que o compilador MOF possa recriar o objeto original. Por exemplo, não há informações sobre os qualificadores propagados ou as propriedades da classe pai.

Para obter uma explicação dessa sintaxe, confira Convenções de documentação para a API de Script.

Sintaxe

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

Parâmetros

iFlags [in, opcional]: Reservado e deve ser 0 (zero) se especificado.

Retornar valor

Se tiver êxito, esse método retornará uma cadeia de caracteres que contém o texto de saída.

Códigos do Erro

Após a conclusão do método GetObjectText_, o objeto Err poderá conter um dos códigos de erro da lista a seguir.

wbemErrFailed – 2147749889 (0x80041001): Erro não especificado.
wbemErrInvalidParameter – 2147749896 (0x80041008): Foi especificado um parâmetro inválido.
wbemErrOutOfMemory – 2147749894 (0x80041006): Não há memória suficiente para concluir a operação.

Exemplos

O código a seguir, obtido do exemplo de código VBScript Listar a definição de uma classe do WMI no formato MOF na Galeria do TechNet, recupera e exibe a representação textual de uma definição de classe do WMI na sintaxe 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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Partilhar via