PutMethod-Funktion

  • Artikel

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