Dela via

PutMethod-funktion

Skapar en metod.

Anmärkning

Det här API:et är endast för internt bruk. Den är inte avsedd för användning från utvecklarkod.

Syntax

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

Parameterar

vFunc [i] Den här parametern används inte.

ptr [i] En pekare till en IWbemClassObject-instans .

wszName [i] Namnet på den metod som ska skapas.

lFlags [i] Reserverad. Den här parametern måste vara 0.

pSignatureIn [i] En pekare till en kopia av __Parameters-systemklassen som innehåller parametrarna in för metoden. Den här parametern ignoreras om den är inställd på null.

pSignatureOut [i] En pekare till en kopia av __Parameters-systemklassen som innehåller parametrarna out för metoden. Den här parametern ignoreras om den är inställd på null.

Returvärde

Följande värden som returneras av den här funktionen definieras i rubrikfilen WbemCli.h , eller så kan du definiera dem som konstanter i koden:

Konstant Värde Description
WBEM_E_INVALID_PARAMETER 0x80041008 En eller flera parametrar är ogiltiga.
WBEM_E_INVALID_DUPLICATE_PARAMETER 0x80041043 Metodparametern [in, out] som anges i både pInSignature - och pOutSignature-objekten har olika kvalificerare.
WBEM_E_MISSING_PARAMETER_ID 0x80041036 En metodparameter saknar specifikationen för kvalificeringen ID .
WBEM_E_NONCONSECUTIVE_PARAMETER_IDS 0x80041038 ID-serien som tilldelas till metodparametrarna är inte i följd eller startar inte vid 0.
WBEM_E_PARAMETER_ID_ON_RETVAL 0x80041039 Returvärdet för en metod har en ID kvalificerare.
WBEM_E_PROPAGATED_METHOD 0x80041034 Ett försök gjordes att återanvända ett befintligt metodnamn från en överordnad klass och signaturerna matchade inte.
WBEM_S_NO_ERROR 0 Funktionsanropet lyckades.

Anmärkningar

Den här funktionen omsluter ett anrop till metoden IWbemClassObject::P utMethod .

Det här metodanropet stöds endast om ptr är en CIM-klassdefinition. Metodmanipulering är inte tillgängligt från IWbemClassObject-pekare som pekar på CIM-instanser.

Användare kan inte skapa metoder med namn som börjar eller slutar med ett understreck. Detta är reserverat för systemklasser och egenskaper.

För en metod beskrivs parametrarna in och out som egenskaper i IWbemClassObject-objekt .

En [in/out] parameter kan definieras genom att lägga till samma egenskap i båda objekten som pekas på av parametrarna pInSignature och pOutSignature . I det här fallet delar egenskaperna samma ID kvalificerarvärde.

Varje egenskap i ett __Parameters annat klassobjekt än ReturnValue måste ha en ID kvalificerare, ett nollbaserat numeriskt värde som identifierar i vilken ordning parametrarna visas. Inga två parametrar kan ha samma ID värde och inget ID värde kan hoppas över. Om något av villkoren inträffar PutMethod returnerar WBEM_E_NONCONSECUTIVE_PARAMETER_IDSfunktionen .

Example

Ett exempel finns i metoden IWbemClassObject::P utMethod .

Kravspecifikation

Plattformar: Se Systemkrav.

Rubrik: WMINet_Utils.idl

.NET Framework-versioner: Tillgänglig sedan 4.7.2

Se även

  • Last updated on