Freigeben über

PutMethod-Funktion

Erstellt eine Methode.

Hinweis

Diese API ist nur für die interne Verwendung vorgesehen. Es ist nicht für die Verwendung aus Entwicklercode vorgesehen.

Syntax

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

Die 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 __Parameters Systemklasse , die die in Parameter für die Methode enthält. Dieser Parameter wird ignoriert, wenn er auf null.

pSignatureOut [in] Ein Zeiger auf eine Kopie der __Parameters Systemklasse , die die out Parameter für die Methode enthält. Dieser Parameter wird ignoriert, wenn er auf null.

Rückgabewert

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

Dauerhaft Wert Description
WBEM_E_INVALID_PARAMETER 0x80041008 Mindestens ein Parameter ist ungültig.
WBEM_E_INVALID_DUPLICATE_PARAMETER 0x80041043 Der [in, out] in den Objekten pInSignature und pOutSignature angegebene Methodenparameter weisen unterschiedliche Qualifizierer auf.
WBEM_E_MISSING_PARAMETER_ID 0x80041036 Ein Methodenparameter fehlt die Spezifikation des ID Qualifizierers.
WBEM_E_NONCONSECUTIVE_PARAMETER_IDS 0x80041038 Die ID-Datenreihe, die den Methodenparametern zugewiesen ist, ist nicht aufeinander folgende oder beginnt nicht mit 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, einen vorhandenen Methodennamen aus einer übergeordneten Klasse wiederzuverwenden, und die Signaturen stimmen nicht überein.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.

Bemerkungen

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

Dieser Methodenaufruf wird nur unterstützt, wenn es sich um ptr eine CIM-Klassendefinition handelt. Methodenmanipulation ist in IWbemClassObject-Zeigern , die auf CIM-Instanzen verweisen, nicht verfügbar.

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

Bei einer Methode werden die in Parameter und out Eigenschaften in IWbemClassObject-Objekten als Eigenschaften beschrieben.

Ein [in/out] Parameter kann durch Hinzufügen derselben Eigenschaft zu beiden Objekten definiert werden, auf die von den pInSignature Parametern verwiesen pOutSignature wird. In diesem Fall verwenden die Eigenschaften denselben ID Qualifiziererwert.

Jede Eigenschaft in einem __Parameters Klassenobjekt, das nicht ReturnValue über einen ID Qualifizierer verfügt, einen nullbasierten numerischen Wert, der die Reihenfolge angibt, in der die Parameter angezeigt werden. Es können keine beiden Parameter denselben ID Wert aufweisen, und kein ID Wert kann übersprungen werden. Wenn eine der Bedingungen auftritt, gibt die PutMethod Funktion zurück WBEM_E_NONCONSECUTIVE_PARAMETER_IDS.

Example

Ein Beispiel finden Sie unter der IWbemClassObject::P utMethod-Methode .

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Kopfball: WMINet_Utils.idl

.NET Framework-Versionen: Verfügbar seit 4.7.2

Siehe auch

  • Last updated on