Partilhar via

Função PutMethod

Cria um método.

Observação

Esta API é apenas para uso interno. Não é destinado a ser usado em código de 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 [dentro] Este parâmetro não é utilizado.

ptr [dentro] Um apontador para uma instância IWbemClassObject .

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

lFlags [dentro] Reservado. Este parâmetro deve ser 0.

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

pSignatureOut [dentro] Um apontador para uma cópia da classe __Parameters system que contém os out parâmetros do método. Este parâmetro é ignorado se definido como null.

Valor de retorno

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 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 tanto nos objetos pInSignature como pOutSignature tem qualificadores diferentes.
WBEM_E_MISSING_PARAMETER_ID 0x80041036 Um parâmetro de método não corresponde à especificação do ID qualificador.
WBEM_E_NONCONSECUTIVE_PARAMETER_IDS 0x80041038 A série 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 de retorno 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 mãe, mas as assinaturas não coincidiram.
WBEM_S_NO_ERROR 0 A chamada de função foi bem-sucedida.

Observações

Esta função envolve 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 através dos ponteiros IWbemClassObject que apontam para instâncias CIM.

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

Para um método, os in parâmetros e out são descritos como propriedades nos 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 . Neste caso, as propriedades partilham o mesmo ID valor qualificativo.

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

Example

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

Requerimentos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: WMINet_Utils.idl

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

Consulte também

  • Last updated on