PutMethod-Funktion

Artikel
06/05/2023

Erstellt eine Methode.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

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

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Ein Zeiger auf eine IWbemClassObject-Instanz.

wszName
[in] Der Name der zu erstellenden Methode.

lFlags
[in]: Reserviert Dieser Parameter muss 0 sein.

pSignatureIn
[in] Ein Zeiger auf eine Kopie der Systemklasse __Parameters, die die in-Parameter für die Methode enthält. Falls auf null festgelegt, wird dieser Parameter ignoriert.

pSignatureOut
[in] Ein Zeiger auf eine Kopie der Systemklasse __Parameters, die die out-Parameter für die Methode enthält. Falls auf null festgelegt, wird dieser Parameter ignoriert.

Rückgabewert

Die folgenden von dieser Funktion zurückgegebenen Werte werden in der Headerdatei WbemCli.h definiert, oder Sie können sie als Konstanten im Code definieren:

Konstante	Wert	BESCHREIBUNG
`WBEM_E_INVALID_PARAMETER`	0x80041008	Mindestens ein Parameter ist ungültig.
`WBEM_E_INVALID_DUPLICATE_PARAMETER`	0x80041043	Der in den Objekten pInSignature und pOutSignature angegebene Methodenparameter `[in, out]` hat unterschiedliche Qualifizierer.
`WBEM_E_MISSING_PARAMETER_ID`	0x80041036	Bei einem Methodenparameter fehlt die Angabe des ID-Qualifizierers.
`WBEM_E_NONCONSECUTIVE_PARAMETER_IDS`	0x80041038	Die den Methodenparametern zugewiesene ID-Reihe ist nicht aufeinanderfolgend oder beginnt nicht bei 0.
`WBEM_E_PARAMETER_ID_ON_RETVAL`	0x80041039	Der Rückgabewert für eine Methode weist einen ID-Qualifizierer auf.
`WBEM_E_PROPAGATED_METHOD`	0x80041034	Es wurde versucht, den vorhandenen Methodennamen einer übergeordneten Klasse zu verwenden, und die Signaturen stimmten nicht überein.
`WBEM_S_NO_ERROR`	0	Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemClassObject::PutMethod-Methode.

Dieser Methodenaufruf wird nur unterstützt, wenn ptr eine CIM-Klassendefinition ist. Die Methodenbearbeitung ist über IWbemClassObject-Zeiger, die auf CIM-Instanzen verweisen, nicht möglich.

Benutzer können keine Methoden mit Namen erstellen, die mit einem Unterstrich beginnen oder enden. Dies ist für Systemklassen und -eigenschaften reserviert.

Für eine Methode werden die Parameter in und out als Eigenschaften in IWbemClassObject-Objekten beschrieben.

Ein [in/out]-Parameter kann definiert werden, indem dieselbe Eigenschaft beiden Objekten hinzugefügt wird, auf die die Parameter pInSignature und pOutSignature zeigen. In diesem Fall verwenden die Eigenschaften denselben ID-Qualifiziererwert.

Jede Eigenschaft in einem __Parameters-Klassenobjekt außer ReturnValue muss über einen ID-Qualifizierer verfügen, einen auf 0 (null) basierenden numerischen Wert, der die Reihenfolge der die Parameter angibt. Keine zwei Parameter dürfen denselben ID-Wert haben, und kein ID-Wert darf übersprungen werden. Wenn eine der beiden Bedingungen eintritt, wird von der PutMethod-Funktion WBEM_E_NONCONSECUTIVE_PARAMETER_IDS zurückgegeben.

Beispiel

Ein Beispiel finden Sie unter IWbemClassObject::PutMethod-Methode.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: seit Version 4.7.2 verfügbar

Siehe auch

WMI und Leistungsindikatoren (Referenz zur nicht verwalteten API)

Freigeben über