Funzione PutMethod

Articolo
05/10/2023

Crea un metodo.

Nota

Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.

Sintassi

HRESULT PutMethod (
   [in] int                vFunc,
   [in] IWbemClassObject*  ptr,
   [in] LPCWSTR            wszName,
   [in] LONG               lFlags,
   [in] IWbemClassObject*  pInSignature,
   [in] IWbemClassObject*  pOutSignature
);

Parametri

vFunc
[in] Questo parametro non è usato.

ptr
[in] Puntatore a un'istanza IWbemClassObject .

wszName
[in] Nome del metodo da creare.

lFlags
[in] Riservato. Questo parametro deve essere 0.

pSignatureIn
[in] Puntatore a una copia della classe di sistema __Parameters che contiene i in parametri per il metodo . Questo parametro viene ignorato se impostato su null.

pSignatureOut
[in] Puntatore a una copia della classe di sistema __Parameters che contiene i out parametri per il metodo . Questo parametro viene ignorato se impostato su null.

Valore restituito

I valori seguenti restituiti da questa funzione sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice:

Costante	Valore	Descrizione
`WBEM_E_INVALID_PARAMETER`	0x80041008	Uno o più parametri non sono validi.
`WBEM_E_INVALID_DUPLICATE_PARAMETER`	0x80041043	Il parametro del `[in, out]` metodo specificato negli oggetti pInSignature e pOutSignature ha qualificatori diversi.
`WBEM_E_MISSING_PARAMETER_ID`	0x80041036	Un parametro del metodo manca la specifica del qualificatore ID .
`WBEM_E_NONCONSECUTIVE_PARAMETER_IDS`	0x80041038	La serie ID assegnata ai parametri del metodo non è consecutiva o non inizia da 0.
`WBEM_E_PARAMETER_ID_ON_RETVAL`	0x80041039	Il valore restituito per un metodo ha un qualificatore ID .
`WBEM_E_PROPAGATED_METHOD`	0x80041034	È stato effettuato un tentativo di riutilizzare un nome di metodo esistente da una classe padre e le firme non corrispondono.
`WBEM_S_NO_ERROR`	0	La chiamata di funzione ha avuto esito positivo.

Commenti

Questa funzione esegue il wrapping di una chiamata al metodo IWbemClassObject::P utMethod .

Questa chiamata al metodo è supportata solo se ptr è una definizione di classe CIM. La manipolazione dei metodi non è disponibile dai puntatori IWbemClassObject che puntano alle istanze CIM.

Gli utenti non possono creare metodi con nomi che iniziano o terminano con un carattere di sottolineatura. Questa opzione è riservata alle classi di sistema e alle proprietà.

Per un metodo, i in parametri e out vengono descritti come proprietà negli oggetti IWbemClassObject .

È possibile definire un [in/out] parametro aggiungendo la stessa proprietà a entrambi gli oggetti a cui puntano i pInSignature parametri e pOutSignature . In questo caso, le proprietà condividono lo stesso valore del qualificatore ID .

Ogni proprietà in un oggetto classe __Parameters diverso ReturnValue da deve avere un qualificatore ID , un valore numerico in base zero che identifica l'ordine in cui vengono visualizzati i parametri. Nessun parametro può avere lo stesso valore ID e non è possibile ignorare alcun valore ID . Se si verifica una delle due condizioni, la PutMethod funzione restituisce WBEM_E_NONCONSECUTIVE_PARAMETER_IDS.

Esempio

Per un esempio, vedere il metodo IWbemClassObject::P utMethod .

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile dalla versione 4.7.2

Vedi anche

WMI e contatori delle prestazioni (riferimenti alle API non gestite)

Condividi tramite