Método SWbemObject.ExecMethod_
O método ExecMethod_ do objeto SWbemObject executa um método exportado por um provedor de métodos.
Esse método é pausado enquanto o método que é encaminhado para o provedor apropriado é executado. As informações e status são retornados. O provedor, e não o WMI, implementa o método.
Para obter uma explicação dessa sintaxe, confira Convenções de documentação para a API de Script.
Sintaxe
objOutParams = .ExecMethod_( _
ByVal strMethodName, _
[ ByVal objwbemInParams ], _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Parâmetros
-
strMethodName [in]
-
Obrigatórios. Nome do método para o objeto.
-
objwbemInParams [in, opcional]
-
Este é um objeto SWbemObject que contém os parâmetros de entrada para o método que está sendo executado. Por padrão, esse parâmetro é indefinido. Para obter mais informações, consulte Construir objetos InParameters e analisar objetos OutParameters.
-
iFlags [in, opcional]
-
Reservado e deverá ser zero (0) se for especificado.
-
objwbemNamedValueSet [in, opcional]
-
Normalmente, ele é indefinido. Caso contrário, esse será um objeto SWbemNamedValueSet cujos elementos representam as informações de contexto que podem ser usadas pelo provedor que está atendendo à solicitação. Um provedor que dê suporte ou exija essas informações deve documentar os nomes de valor reconhecidos, o tipo de dados do valor, os valores permitidos e a semântica.
Retornar valor
Se esse método for bem-sucedido, um objeto SWbemObject retornará. O objeto retornado contém os parâmetros de saída e o valor retornado para o método sendo executado.
Códigos do Erro
Após a conclusão do método ExecMethod_, o objeto Err poderá conter um dos códigos de erro na lista a seguir.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Erro não especificado.
-
wbemErrInvalidClass – 2147749904 (0x80041010)
-
A classe especificada não era válida.
-
wbemErrInvalidParameter – 2147749896 (0x80041008)
-
Um parâmetro especificado não é válido.
-
wbemErrOutOfMemory – 2147749894 (0x80041006)
-
Não há memória suficiente para concluir a operação.
-
wbemErrInvalidMethod – 2147749934 (0x8004102E)
-
O método solicitado não estava disponível.
-
wbemErrAccessDenied – 2147749891 (0x80041003)
-
O usuário atual não estava autorizado a executar o método.
Comentários
Esse método é semelhante a SWbemServices.ExecMethod, mas opera diretamente no objeto cujo método deve ser executado. Por exemplo, o exemplo de código a seguir chama o método de provedor StartService no Win32_Service e usa acesso direto.
oService = GetObject("winmgmts:Win32_Service=Alerter")
iStatus = oService.StartService()
Esta versão chama SWbemObject.ExecMethod_ para executar o método StartService.
oService = GetObject("winmgmts:Win32_Service=Alerter")
Set outParam = process.ExecMethod_("StartService")
Use SWbemObject.ExecMethod_ como uma alternativa ao acesso direto para executar um método de provedor nos casos em que não for possível executar um método diretamente. Por exemplo, você usaria SWbemObject.ExecMethod_ com uma linguagem de script sem suporte para parâmetros de saída se o método tivesse parâmetros de saída. Caso contrário, o meio recomendado para invocar um método será usar o acesso direto.
- O método SWbemObject.ExecMethod_ pressupõe que o objeto representado por SWbemObject contém o método a ser executado. Em comparação, SWbemServices.ExecMethod requer um caminho de objeto. Use SWbemObject.ExecMethod_ se você já tiver obtido o objeto cujo método deseja executar.
Exemplos
O exemplo a seguir mostra o método ExecMethod. O script cria um objeto Win32_Process que representa um processo que executa o Bloco de Notas. Para obter mais informações sobre um script que ilustra as mesmas operações executadas de modo assíncrono, consulte SWbemObject.ExecMethodAsync_. Para ver um exemplo de como usar o acesso direto, confira Criar método na classe Win32_Process. Para obter um exemplo da mesma operação usando um objeto SWbemServices, consulte SWbemServices.ExecMethod.
' Connect to WMI and obtain a Win32_Process object.
' This is also an SWbemObject object.
Set oProcess = GetObject("winmgmts:Win32_Process")
' Create the SWbemMethod.InParameters
' object to hold the input parameter needed
' for the Win32_Process.Create method call.
' The oProcess.Methods_("Create") call
' obtains a class object that defines
' the correct input parameters
' for the Win32_Process.Create call.
' The InParameters object is an
' SWbemObject object so SWbemObject.SpawnInstance_
' can be called to create it.
Set oInParams = oProcess.Methods_("Create"). _
InParameters.SpawnInstance_
' Specify the name of the process to be run.
oInParams.CommandLine = "Notepad.exe"
Set oOutParams = oProcess.ExecMethod_("Create", oInParams)
If oOutParams.ReturnValue = 0 Then
wscript.echo "Create method executed successfully"
Else
' If the Create method failed to execute,
' an empty OutParameters object is returned.
If IsNull(oOutParams.ReturnValue) Then
wscript.echo "Create method failed to execute."
Else
wscript.echo "Create method executed but had error" _
& "0x" & hex(oOutParams.ReturnValue)
End If
End If
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Cabeçalho |
|
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |