Función PutMethod

Crea un método .

Nota:

Esta API es solo para uso interno. No está pensado para su uso desde el código de desarrollador.

Syntax

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 no se usa.

ptr [in] Puntero a una instancia de IWbemClassObject .

wszName [in] Nombre del método que se va a crear.

lFlags [in] Reservado. Este parámetro debe ser 0.

pSignatureIn [in] Puntero a una copia de la clase del sistema __Parameters que contiene los in parámetros del método . Este parámetro se omite si se establece en null.

pSignatureOut [in] Puntero a una copia de la clase del sistema __Parameters que contiene los out parámetros del método . Este parámetro se omite si se establece en null.

Valor devuelto

Los siguientes valores devueltos por esta función se definen en el archivo de encabezado WbemCli.h , o bien puede definirlos como constantes en el código:

Constante	Importancia	Description
WBEM_E_INVALID_PARAMETER	0x80041008	Uno o varios parámetros no son válidos.
WBEM_E_INVALID_DUPLICATE_PARAMETER	0x80041043	El [in, out] parámetro de método especificado en los objetos pInSignature y pOutSignature tienen calificadores diferentes.
WBEM_E_MISSING_PARAMETER_ID	0x80041036	Falta un parámetro de método para la especificación del ID calificador.
WBEM_E_NONCONSECUTIVE_PARAMETER_IDS	0x80041038	La serie de identificadores que se asigna a los parámetros del método no es consecutiva o no comienza en 0.
WBEM_E_PARAMETER_ID_ON_RETVAL	0x80041039	El valor devuelto de un método tiene un ID calificador.
WBEM_E_PROPAGATED_METHOD	0x80041034	Se intentó reutilizar un nombre de método existente de una clase primaria y las firmas no coincidieron.
WBEM_S_NO_ERROR	0	La llamada de función se realizó correctamente.

Observaciones

Esta función ajusta una llamada al método IWbemClassObject::P utMethod .

Esta llamada al método solo se admite si ptr es una definición de clase CIM. La manipulación de métodos no está disponible desde punteros IWbemClassObject que apuntan a instancias CIM.

Los usuarios no pueden crear métodos con nombres que comiencen o terminen con un carácter de subrayado. Esto está reservado para las propiedades y clases del sistema.

Para un método, los in parámetros y out se describen como propiedades en objetos IWbemClassObject .

Un [in/out] parámetro se puede definir agregando la misma propiedad a ambos objetos a los que apuntan los pInSignature parámetros y pOutSignature . En este caso, las propiedades comparten el mismo ID valor calificador.

Cada propiedad de un objeto de clase __Parameters distinto ReturnValue de debe tener un ID calificador, un valor numérico de base cero que identifica el orden en el que aparecen los parámetros. Ningún parámetro puede tener el mismo ID valor y no se puede omitir ningún ID valor. Si se produce alguna condición, la PutMethod función devuelve WBEM_E_NONCONSECUTIVE_PARAMETER_IDS.

Example

Para obtener un ejemplo, vea el método IWbemClassObject::P utMethod .

Requisitos

Plataformas: Consulte Requisitos del sistema.

Encabezado: WMINet_Utils.idl

Versiones de .NET Framework: Disponible desde la versión 4.7.2

Consulte también

• Contadores de rendimiento y WMI (referencia de API no administrada)