De functie GetPropertyQualifierSet

Hiermee haalt u de kwalificatieset voor een bepaalde eigenschap op.

Notitie

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

Syntaxis

HRESULT GetPropertyQualifierSet (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszProperty,
   [out] IWbemQualifierSet  **ppQualSet
);

Parameters

vFunc
[in] Deze parameter wordt niet gebruikt.

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

wszMethod
[in] De naam van de eigenschap. wszProperty moet verwijzen naar een geldige LPCWSTR.

ppQualSet
[uit] Hiermee ontvangt u de interfacepointer die toegang biedt tot de kwalificaties van de eigenschap. ppQualSet mag niet zijn null. Als er een fout optreedt, wordt er geen nieuw object geretourneerd en wordt de aanwijzer ingesteld op .null

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_FAILED	0x80041001	Er is een algemene fout opgetreden.
WBEM_E_NOT_FOUND	0x80041002	De opgegeven methode bestaat niet.
WBEM_E_OUT_OF_MEMORY	0x80041006	Er is onvoldoende geheugen beschikbaar om de bewerking te voltooien.
WBEM_E_INVALID_PARAMETER	0x80041008	Een parameter is null.
WBEM_E_SYSTEM_PROPERTY	0x80041030	De functie probeert kwalificaties van een systeemeigenschap op te halen.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Deze functie verpakt een aanroep naar de methode IWbemClassObject::GetPropertyQualifierSet .

Een aanroep van deze functie wordt alleen ondersteund als het huidige object een CIM-klassedefinitie is. Methodemanipulatie is niet beschikbaar voor IWbemClassObject-aanwijzers die verwijzen naar CIM-exemplaren.

Omdat elke methode zijn eigen kwalificaties kan hebben, kan de aanwijzer IWbemQualifierSet de aanroeper deze kwalificaties toevoegen, bewerken of verwijderen.

Omdat systeemeigenschappen geen kwalificaties hebben, retourneert WBEM_E_SYSTEM_PROPERTY de functie als u een IWbemQualifierSet-aanwijzer voor een systeemeigenschap probeert te verkrijgen.

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)