Metodo IWbemClassObject::GetMethod (wbemcli.h)

Articolo
08/27/2023

Il metodo IWbemClassObject::GetMethod restituisce informazioni sul metodo richiesto. Questa chiamata è supportata solo se l'oggetto corrente è una definizione di classe CIM. Le informazioni sul metodo non sono disponibili dai puntatori IWbemClassObject che puntano alle istanze CIM.

Sintassi

HRESULT GetMethod(
  [in]  LPCWSTR          wszName,
  [in]  long             lFlags,
  [out] IWbemClassObject **ppInSignature,
  [out] IWbemClassObject **ppOutSignature
);

Parametri

[in] wszName

Nome del metodo. Non può essere NULL e deve puntare a un LPCWSTR valido.

[in] lFlags

Riservato. Questo parametro deve essere 0.

[out] ppInSignature

Puntatore che riceve un puntatore IWbemClassObject che descrive i parametri nel metodo . Questo parametro viene ignorato se impostato su NULL. Tenere presente che Gestione Windows può impostare il puntatore IWbemClassObject su NULL se questo metodo non ha parametri. Per altre informazioni, vedere la sezione Osservazioni.

[out] ppOutSignature

Puntatore che riceve un puntatore IWbemClassObject che descrive i parametri out al metodo . Questo parametro verrà ignorato se impostato su NULL.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in hrESULT. Per i valori HRESULT generali, vedere Codici di errore di sistema.

Commenti

Per un metodo, i parametri in e out vengono descritti come proprietà in un IWbemClassObject, un'istanza della classe di sistema __Parameters.

Si consideri ad esempio il metodo seguente:

Class MyClass{
    [key] string KeyVal;
    sint32 PropVal;
    sint32 ExampleMethod([in] sint32 Parm1, [in] uint32 Parm2, 
      [out] string Parm3);
};

In questo esempio la classe ha un singolo metodo. Quando l'utente chiama IWbemClassObject::GetMethod, il parametro ppInSignature riceve un oggetto IWbemClassObject , che contiene due proprietà: Parm1 e Parm2. Il parametro ppOutSignature contiene due proprietà, Parm3 e ReturnValue.

Dopo aver compilato i valori delle proprietà dell'oggetto ppInSignature , il chiamante può utilizzare l'oggetto per eseguire il metodo chiamando IWbemServices::ExecMethod o IWbemServices::ExecMethodAsync.

Nota Il chiamante deve chiamare IWbemClassObject::Release nei puntatori ppInSignature e ppOutSignature quando questi oggetti non sono più necessari.

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemcli.h (include Wbemidl.h)
Libreria	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Vedi anche

IWbemClassObject

IWbemClassObject::P utMethod

Condividi tramite