Condividi tramite

Funzione PutMethod

Crea un metodo.

Annotazioni

Questa API è solo per uso interno. Non è destinato 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 di 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 Value Description
WBEM_E_INVALID_PARAMETER 0x80041008 Uno o più parametri non sono validi.
WBEM_E_INVALID_DUPLICATE_PARAMETER 0x80041043 Il [in, out] parametro del metodo specificato negli oggetti pInSignature e pOutSignature ha qualificatori diversi.
WBEM_E_MISSING_PARAMETER_ID 0x80041036 Un parametro del metodo manca la specifica del ID qualificatore.
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 ID qualificatore.
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.

Osservazioni:

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 e alle proprietà di sistema.

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 ID valore del qualificatore.

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

Example

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

Requisiti

Piattaforme: Vedere Requisiti di sistema.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile dalla versione 4.7.2

Vedere anche

  • Last updated on