Compartilhar via

Função PutMethod

Cria um método.

Observação

Essa API é apenas para uso interno. Ele não se destina 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 é usado.

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 in parâmetros do método. Esse parâmetro será ignorado se definido como null.

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

Valor de retorno

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 Value Description
WBEM_E_INVALID_PARAMETER 0x80041008 Um ou mais parâmetros não são válidos.
WBEM_E_INVALID_DUPLICATE_PARAMETER 0x80041043 O [in, out] parâmetro de método especificado nos objetos pInSignature e pOutSignature tem qualificadores diferentes.
WBEM_E_MISSING_PARAMETER_ID 0x80041036 Um parâmetro de método não tem a especificação do ID qualificador.
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 de um método tem um ID qualificador.
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 corresponderam.
WBEM_S_NO_ERROR 0 A chamada de função foi bem-sucedida.

Observações

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

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 nos 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 classes e propriedades do sistema.

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

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

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

Example

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

Requirements

Plataformas: confira Requisitos do sistema.

Cabeçalho: WMINet_Utils.idl

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

Consulte também

  • Last updated on