GetPropertyHandle, functie

Retourneert een unieke ingang die een eigenschap identificeert.

Notitie

Deze API is alleen voor intern gebruik. Het is niet bedoeld voor gebruik vanuit ontwikkelaarscode.

Syntaxis

HRESULT GetPropertyHandle (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] LPCWSTR              wszPropertyName,
   [out] CIMTYPE*            pType,
   [out] long*               pHandle
);

Parameters

vFunc
[in] Deze parameter wordt niet gebruikt.

ptr
[in] Een aanwijzer naar een IWbemObjectAccess-exemplaar .

wszPropertyName
[in] Een null-beëindigde tekenreeks met UTF16-gecodeerde tekens die de naam van de eigenschap bevat.

pType
[uit] Een verwijzing naar een CIMTYPE opsommingslid dat het CIM-type van de eigenschap vertegenwoordigt.

pHandle
[uit] Een aanwijzer naar een geheel getal dat de eigenschapsgreep bevat.

Retourwaarde

De volgende waarden die door deze functie worden geretourneerd, worden gedefinieerd in het headerbestand WbemCli.h . U kunt ze ook definiëren als constanten in uw code:

Constant	Waarde	Beschrijving
WBEM_E_NOT_FOUND	0x80041002	De opgegeven eigenschapsnaam is niet gevonden.
WBEM_E_INVALID_PARAMETER	0x80041008	Een parameter is ongeldig.
WBEM_E_NOT_SUPPORTED	0x8004100c	De aangevraagde eigenschap is van het type zijn CIM_OBJECT of CIM_ARRAY.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Deze functie verpakt een aanroep van de methode IWbemClassObject::GetPropertyHandle .

U kunt deze ingang gebruiken om eigenschappen te identificeren wanneer u IWbemObjectAccess-methoden gebruikt om eigenschapswaarden te lezen of te schrijven.

Ingangen kunnen worden opgehaald voor eigenschappen van alle gegevenstypen behalve CIM_OBJECT en CIM_ARRAY. Geretourneerde ingangen werken in alle exemplaren van een klasse.

Vereisten

Platforms: Zie Systeemvereisten.

Header: WMINet_Utils.idl

.NET Framework versies: beschikbaar sinds 4.7.2

Zie ook

• WMI en prestatiemeteritems (niet-beheerde API-verwijzing)