Función NextMethod
Recupera el método siguiente de una enumeración que comienza con una llamada a BeginMethodEnumeration.
Nota
Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.
Sintaxis
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 no se usa.
ptr
[in] Puntero a una instancia de IWbemClassObject.
lFlags
[in] Reservado. Este parámetro debe ser 0.
pName
[out] Puntero que apunta a null antes de la llamada. Cuando se devuelve la función, la dirección de un nuevo objeto BSTR que contiene el nombre del método.
ppSignatureIn
[out] Puntero que recibe un puntero a un objeto IWbemClassObject que contiene los parámetros in del método.
ppSignatureOut
[out] Puntero que recibe un puntero a un objeto IWbemClassObject que contiene los parámetros out del método.
Valor devuelto
Los siguientes valores que devuelve esta función se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlos como constantes en el código. Puede consultarlos a continuación:
| Constante | Value | Descripción |
|---|---|---|
WBEM_E_UNEXPECTED |
0x8004101d | No hubo ninguna llamada a la función BeginEnumeration. |
WBEM_S_NO_ERROR |
0 | Si se devuelve este valor, significará que la llamada a la función se realizó correctamente. |
WBEM_S_NO_MORE_DATA |
0x40005 | No hay más propiedades en la enumeración. |
Comentarios
Esta función ajusta una llamada al método IWbemClassObject::NextMethod.
El llamador inicia la secuencia de enumeración mediante una llamada a la función BeginMethodEnumeration y, luego, llama a la función [NextMethod] hasta que la función devuelve WBEM_S_NO_MORE_DATA. Opcionalmente, el llamador finaliza la secuencia mediante una llamada a EndMethodEnumeration. El llamador puede finalizar la enumeración antes mediante una llamada a EndMethodEnumeration en cualquier momento.
Ejemplo
Para obtener un ejemplo de C++, consulte el método IWbemClassObject::NextMethod.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: WMINet_Utils.idl
Versiones de .NET Framework: está disponible desde la versión 4.7.2
