Função PutMethod

Artigo
05/10/2023

Cria um método.

Observação

Esta API é somente para uso interno. Ela não é destinada ao uso do código do desenvolvedor.

Sintaxe

HRESULT PutMethod (
   [in] int                vFunc,
   [in] IWbemClassObject*  ptr,
   [in] LPCWSTR            wszName,
   [in] LONG               lFlags,
   [in] IWbemClassObject*  pInSignature,
   [in] IWbemClassObject*  pOutSignature
);

Parâmetros

vFunc
[in] Esse parâmetro não está em uso.

ptr
[in] Um ponteiro para uma instância IWbemClassObject.

wszName
[in] O nome do método a ser criado.

lFlags
[in] Reservado. Esse parâmetro deve ser 0.

pSignatureIn
[in] Um ponteiro para uma cópia da classe do sistema __Parameters que contém os parâmetros in do método. Esse parâmetro será ignorado se for definido como null.

pSignatureOut
[in] Um ponteiro para uma cópia da classe do sistema __Parameters que contém os parâmetros out do método. Esse parâmetro será ignorado se for definido como null.

Valor retornado

Os seguintes valores retornados por essa função são definidos no arquivo de cabeçalho WbemCli.h, ou você pode defini-los como constantes em seu código:

Constante	Valor	Descrição
`WBEM_E_INVALID_PARAMETER`	0x80041008	Um ou mais dos parâmetros não são válidos.
`WBEM_E_INVALID_DUPLICATE_PARAMETER`	0x80041043	O parâmetro do método `[in, out]` especificado nos objetos pInSignature e pOutSignature têm qualificadores diferentes.
`WBEM_E_MISSING_PARAMETER_ID`	0x80041036	Um parâmetro de método não tem a especificação do qualificador de ID.
`WBEM_E_NONCONSECUTIVE_PARAMETER_IDS`	0x80041038	A série de ID atribuída aos parâmetros do método não é consecutiva ou não começa em 0.
`WBEM_E_PARAMETER_ID_ON_RETVAL`	0x80041039	O valor retornado para um método tem um qualificador de ID.
`WBEM_E_PROPAGATED_METHOD`	0x80041034	Foi feita uma tentativa de reutilizar um nome de método existente de uma classe pai e as assinaturas não correspondem.
`WBEM_S_NO_ERROR`	0	A chamada de função foi bem-sucedida.

Comentários

Essa função encapsula uma chamada para o método IWbemClassObject::PutMethod.

Essa chamada de método só terá suporte se ptr for uma definição de classe CIM. A manipulação de método não está disponível em ponteiros IWbemClassObject que apontam para instâncias CIM.

Os usuários não podem criar métodos com nomes que começam ou terminam com um sublinhado. Isso é reservado para propriedades e classes de sistema.

Para um método, os parâmetros in e out são descritos como propriedades em objetos IWbemClassObject.

Um parâmetro [in/out] pode ser definido adicionando a mesma propriedade a ambos os objetos apontados pelos parâmetros pInSignature e pOutSignature. Nesse caso, as propriedades compartilham o mesmo valor do qualificador de ID.

Cada propriedade em um objeto de classe __Parameters que não seja ReturnValue deve ter um qualificador de ID, um valor numérico baseado em zero que identifica a ordem na qual os parâmetros aparecem. Nenhum parâmetro pode ter o mesmo valor de ID e nenhum valor de ID pode ser ignorado. Se qualquer uma das condições ocorrer, a função PutMethod retornará WBEM_E_NONCONSECUTIVE_PARAMETER_IDS.

Exemplo

Para obter um exemplo, consulte o método IWbemClassObject::PutMethod.

Requisitos

Plataformas: confira Requisitos do sistema.

Header: WMINet_Utils.idl

Versões do .NET Framework: Disponível desde 4.7.2

Confira também

WMI e Contadores de Desempenho (Referência de API Não Gerenciada)

Compartilhar via