Função NextMethod

Artigo
05/10/2023

Recupera o próximo método em uma enumeração que começa com uma chamada para BeginMethodEnumeration.

Observação

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

Sintaxe

HRESULT NextMethod (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LONG                lFlags,
   [out] BSTR*              pName,
   [out] IWbemClassObject** ppInSignature,
   [out] IWbemClassObject** ppOutSignature
);

Parâmetros

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

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

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

pName
[out] Um ponteiro que aponta para null antes da chamada. Quando a função retorna, o endereço de uma nova BSTR que contém o nome do método.

ppSignatureIn
[out] Um ponteiro que recebe um ponteiro para um IWbemClassObject que contém os parâmetros in do método.

ppSignatureOut
[out] Um ponteiro que recebe um ponteiro para um IWbemClassObject que contém os parâmetros out do método.

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_UNEXPECTED`	0x8004101d	Não houve nenhuma chamada para a função `BeginEnumeration`.
`WBEM_S_NO_ERROR`	0	A chamada de função foi bem-sucedida.
`WBEM_S_NO_MORE_DATA`	0x40005	Não há mais propriedades na enumeração.

Comentários

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

O chamador inicia a sequência de enumeração usando a função BeginMethodEnumeration e, em seguida chama a função [NextMethod] até que a função retorne WBEM_S_NO_MORE_DATA. Opcionalmente, o chamador termina a sequência chamando EndMethodEnumeration. O chamador pode encerrar a enumeração antecipadamente chamando EndMethodEnumeration a qualquer momento.

Exemplo

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

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