Função NextMethod
Obtém o método seguinte numa enumeração que começa com uma chamada para BeginMethodEnumeration.
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 NextMethod (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LONG lFlags,
[out] BSTR* pName,
[out] IWbemClassObject** ppInSignature,
[out] IWbemClassObject** ppOutSignature
);
Parâmetros
vFunc
[in] Este parâmetro não é utilizado.
ptr
[in] Um ponteiro para uma instância IWbemClassObject .
lFlags
[in] Reservado. Este parâmetro tem de ser 0.
pName
[fora] Um ponteiro que aponta para null antes da chamada. Quando a função é devolvida, o endereço de um novo BSTR que contém o nome do método.
ppSignatureIn
[fora] Um ponteiro que recebe um ponteiro para um IWbemClassObject que contém os in parâmetros do método.
ppSignatureOut
[fora] Um ponteiro que recebe um ponteiro para um IWbemClassObject que contém os out parâmetros do método.
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_UNEXPECTED |
0x8004101d | Não houve nenhuma chamada para a BeginEnumeration função. |
WBEM_S_NO_ERROR |
0 | A chamada de função foi efetuada com êxito. |
WBEM_S_NO_MORE_DATA |
0x40005 | Não existem mais propriedades na enumeração. |
Observações
Esta função encapsula uma chamada para o método IWbemClassObject::NextMethod .
O autor da chamada inicia a sequência de enumeração ao chamar a função BeginMethodEnumeration e, em seguida, chama a função [NextMethod] até a função devolver WBEM_S_NO_MORE_DATA. Opcionalmente, o autor da chamada termina a sequência ao chamar EndMethodEnumeration. O autor da chamada pode terminar a enumeração mais cedo ao chamar EndMethodEnumeration em qualquer altura.
Exemplo
Para obter um exemplo de C++, veja o método IWbemClassObject::NextMethod .
Requisitos
Plataformas: Veja Requisitos do Sistema.
Cabeçalho: WMINet_Utils.idl
.NET Framework Versões: Disponível desde 4.7.2
