Função PutMethod

Artigo
04/08/2023

Cria um método.

Nota

Esta API destina-se apenas a utilização interna. Não se destina a ser utilizado a partir do código do programador.

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] Este parâmetro não é utilizado.

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

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

lFlags
[in] Reservado. Este parâmetro tem de ser 0.

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

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

Valor devolvido

Os seguintes valores devolvidos por esta função são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no seu código:

Constante	Valor	Descrição
`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 do método especificado nos objetos pInSignature e pOutSignature tem qualificadores diferentes.
`WBEM_E_MISSING_PARAMETER_ID`	0x80041036	Falta a especificação do qualificador de ID para um parâmetro de método.
`WBEM_E_NONCONSECUTIVE_PARAMETER_IDS`	0x80041038	A série de IDs 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 devolvido de um método tem um qualificador de ID .
`WBEM_E_PROPAGATED_METHOD`	0x80041034	Foi feita uma tentativa de reutilização de um nome de método existente a partir de uma classe principal e as assinaturas não correspondem.
`WBEM_S_NO_ERROR`	0	A chamada de função foi efetuada com êxito.

Observações

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

Esta chamada de método só é suportada se ptr for uma definição de classe CIM. A manipulação de métodos não está disponível a partir de ponteiros IWbemClassObject que apontem para instâncias CIM.

Os utilizadores não podem criar métodos com nomes que comecem ou terminem com um caráter de sublinhado. Isto está reservado para classes e propriedades do sistema.

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

Um [in/out] parâmetro pode ser definido ao adicionar a mesma propriedade a ambos os objetos apontados pelos pInSignature parâmetros e pOutSignature . Neste caso, as propriedades partilham o mesmo valor de qualificação de ID .

Cada propriedade num objeto de classe __Parameters diferente de ReturnValue tem de ter um qualificador de ID , um valor numérico baseado em zero que identifica a ordem pela qual os parâmetros são apresentados. Não é possível ignorar dois parâmetros com o mesmo valor de ID e não é possível ignorar nenhum valor de ID . Se ocorrer uma condição, a PutMethod função devolve WBEM_E_NONCONSECUTIVE_PARAMETER_IDS.

Exemplo

Por exemplo, veja o método IWbemClassObject::P utMethod .

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: WMINet_Utils.idl

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

Ver também

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

Partilhar via