PutMethod, funkcja

Tworzy metodę.

Uwaga / Notatka

Ten interfejs API jest przeznaczony tylko do użytku wewnętrznego. Nie jest ona przeznaczona do użycia z kodu dewelopera.

Składnia

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

Parametry

vFunc [in] Ten parametr jest nieużywany.

ptr [in] Wskaźnik do wystąpienia IWbemClassObject .

wszName [in] Nazwa metody do utworzenia.

lFlags [in] Zastrzeżony. Ten parametr musi mieć wartość 0.

pSignatureIn [in] Wskaźnik do kopii klasy systemowej __Parameters zawierającej in parametry metody . Ten parametr jest ignorowany, jeśli ustawiono wartość null.

pSignatureOut [in] Wskaźnik do kopii klasy systemowej __Parameters zawierającej out parametry metody . Ten parametr jest ignorowany, jeśli ustawiono wartość null.

Wartość zwracana

Następujące wartości zwracane przez tę funkcję są zdefiniowane w pliku nagłówka WbemCli.h lub można je zdefiniować jako stałe w kodzie:

Stały	Wartość	Description
WBEM_E_INVALID_PARAMETER	0x80041008	Co najmniej jeden parametr jest nieprawidłowy.
WBEM_E_INVALID_DUPLICATE_PARAMETER	0x80041043	Parametr [in, out] metody określony zarówno w obiektach pInSignature , jak i pOutSignature ma różne kwalifikatory.
WBEM_E_MISSING_PARAMETER_ID	0x80041036	Brak specyfikacji kwalifikatora parametru ID metody.
WBEM_E_NONCONSECUTIVE_PARAMETER_IDS	0x80041038	Seria identyfikatorów przypisana do parametrów metody nie jest kolejna lub nie rozpoczyna się od 0.
WBEM_E_PARAMETER_ID_ON_RETVAL	0x80041039	Wartość zwracana dla metody ma ID kwalifikator.
WBEM_E_PROPAGATED_METHOD	0x80041034	Podjęto próbę ponownego użycia istniejącej nazwy metody z klasy nadrzędnej, a podpisy nie były zgodne.
WBEM_S_NO_ERROR	0	Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

Ta funkcja opakowuje wywołanie metody IWbemClassObject::P utMethod .

To wywołanie metody jest obsługiwane tylko wtedy, gdy ptr jest definicją klasy MODELU CIM. Manipulowanie metodą nie jest dostępne w wskaźnikach IWbemClassObject wskazujących wystąpienia modelu CIM.

Użytkownicy nie mogą tworzyć metod z nazwami rozpoczynającymi się lub kończącymi znakiem podkreślenia. Jest to zarezerwowane dla klas i właściwości systemowych.

W przypadku metody in parametry i out są opisywane jako właściwości w obiektach IWbemClassObject .

Parametr [in/out] można zdefiniować, dodając tę samą właściwość do obu obiektów wskazywanych przez pInSignature parametry i pOutSignature . W tym przypadku właściwości mają taką samą ID wartość kwalifikatora.

Każda właściwość w obiekcie klasy __Parameters innym niż ReturnValue musi mieć ID kwalifikator, wartość liczbową opartą na zera, która identyfikuje kolejność wyświetlania parametrów. Żadne dwa parametry nie mogą mieć tej samej ID wartości i nie można pominąć żadnej ID wartości. Jeśli wystąpi dowolny warunek, PutMethod funkcja zwraca WBEM_E_NONCONSECUTIVE_PARAMETER_IDSwartość .

Example

Przykład można znaleźć w metodzie IWbemClassObject::P utMethod .

Requirements

Platformy: Zobacz Wymagania systemowe.

Nagłówek: WMINet_Utils.idl

Wersje programu .NET Framework: Dostępne od wersji 4.7.2

Zobacz także

• Liczniki wydajności i usługi WMI (niezarządzana dokumentacja interfejsu API)