Sdílet prostřednictvím

PutMethod – funkce

Vytvoří metodu.

Poznámka:

Toto rozhraní API je určené jenom pro interní použití. Není určen pro použití z vývojářského kódu.

Syntaxe

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

Parametry

vFunc [v] Tento parametr se nepoužívá.

ptr [v] Ukazatel na instanci IWbemClassObject .

wszName [v] Název metody, která se má vytvořit.

lFlags [v] Rezervovaný. Tento parametr musí být 0.

pSignatureIn [v] Ukazatel na kopii __Parameters systémové třídy , která obsahuje in parametry pro metodu. Tento parametr je ignorován, pokud je nastaven na nullhodnotu .

pSignatureOut [v] Ukazatel na kopii __Parameters systémové třídy , která obsahuje out parametry pro metodu. Tento parametr je ignorován, pokud je nastaven na nullhodnotu .

Návratová hodnota

Následující hodnoty vrácené touto funkcí jsou definovány v souboru záhlaví WbemCli.h nebo je můžete definovat jako konstanty v kódu:

Konstanta Hodnota Description
WBEM_E_INVALID_PARAMETER 0x80041008 Nejméně jeden parametr není platný.
WBEM_E_INVALID_DUPLICATE_PARAMETER 0x80041043 Parametr [in, out] metody zadaný v objektech pInSignature i pOutSignature mají různé kvalifikátory.
WBEM_E_MISSING_PARAMETER_ID 0x80041036 Chybí parametr metody specifikace kvalifikátoru ID .
WBEM_E_NONCONSECUTIVE_PARAMETER_IDS 0x80041038 Řada ID přiřazená parametrům metody není po sobě jdoucí nebo nezačíná na 0.
WBEM_E_PARAMETER_ID_ON_RETVAL 0x80041039 Návratová hodnota pro metodu ID má kvalifikátor.
WBEM_E_PROPAGATED_METHOD 0x80041034 Došlo k pokusu o opakované použití existujícího názvu metody z nadřazené třídy a podpisy se neshodovaly.
WBEM_S_NO_ERROR 0 Volání funkce bylo úspěšné.

Poznámky

Tato funkce zabalí volání metody IWbemClassObject::P utMethod .

Toto volání metody je podporováno pouze v případě, že ptr je definice třídy CIM. Manipulace s metodami není k dispozici z ukazatelů IWbemClassObject , které odkazují na instance CIM.

Uživatelé nemůžou vytvářet metody s názvy, které začínají nebo končí podtržítkem. Toto je vyhrazeno pro systémové třídy a vlastnosti.

Pro metodu in jsou parametry out popsány jako vlastnosti v IWbemClassObject objekty.

Parametr [in/out] lze definovat přidáním stejné vlastnosti do obou objektů, na které pInSignature odkazují parametry.pOutSignature V tomto případě vlastnosti sdílejí stejnou ID kvalifikátorovou hodnotu.

Každá vlastnost v jiném objektu třídy __Parameters než ReturnValue musí mít ID kvalifikátor, číselnou hodnotu založenou na nule, která identifikuje pořadí, ve kterém se parametry zobrazují. Žádné dva parametry nemohou mít stejnou ID hodnotu a nelze ji ID přeskočit. Pokud dojde k některé z podmínek, PutMethod vrátí WBEM_E_NONCONSECUTIVE_PARAMETER_IDSfunkce .

Example

Příklad, viz IWbemClassObject::P utMethod metoda.

Požadavky

Platformy: Viz požadavky na systém.

Záhlaví: WMINet_Utils.idl

Verze rozhraní .NET Framework: K dispozici od verze 4.7.2

Viz také

  • Last updated on