GetNames, functie

Hiermee haalt u een subset of alle namen van de eigenschappen van een object op.

Notitie

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

Syntaxis

HRESULT GetNames (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszQualifierName,
   [in] LONG                lFlags,
   [in] VARIANT*            pQualifierValue,
   [out] SAFEARRAY (BSTR)** pstrNames
);

Parameters

vFunc
[in] Deze parameter wordt niet gebruikt.

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

wszQualifierName
[in] Een verwijzing naar een geldige LPCWSTR die een kwalificatienaam opgeeft die als onderdeel van een filter werkt. Zie de sectie Opmerkingen voor meer informatie. Deze parameter kan zijn null.

lFlags
[in] Een combinatie van bitvelden. Zie de sectie Opmerkingen voor meer informatie.

pQualifierValue [in] Een aanwijzer naar een geldige VARIANT structuur die is geïnitialiseerd naar een filterwaarde. Deze parameter kan zijn null.

pstrNames
[uit] Een SAFEARRAY structuur die eigenschapsnamen bevat. Bij invoer moet deze parameter altijd een verwijzing naar nullzijn. Zie de sectie Opmerkingen voor meer informatie.

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_INVALID_PARAMETER	0x80041008	Een of meer parameters zijn ongeldig of er is een onjuiste combinatie van vlaggen en parameters opgegeven.
WBEM_E_OUT_OF_MEMORY	0x80041006	Er is onvoldoende geheugen beschikbaar om de bewerking te voltooien.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Met deze functie wordt een aanroep van de methode IWbemClassObject::GetNames verpakt.

De benoemde geretourneerde worden beheerd door een combinatie van vlaggen en parameters. De functie kan bijvoorbeeld de namen van alle eigenschappen of alleen de namen van de sleuteleigenschappen retourneren. Het primaire filter wordt opgegeven in de lFlags parameter en de andere parameters variëren afhankelijk van het filter.

De vlagwaarden in lFlags zijn bitvelden

De vlaggen die als argument lEnumFlags kunnen worden doorgegeven, zijn bitvelden die zijn gedefinieerd in het headerbestand WbemCli.h . U kunt ze ook definiëren als constanten in uw code. U kunt één vlag uit elke groep combineren met een vlag uit een andere groep. Vlaggen van dezelfde groep sluiten elkaar echter uit.

Groep 1-vlaggen	Waarde	Beschrijving
WBEM_FLAG_ALWAYS	0	Retourneer alle eigenschapsnamen. strQualifierName en pQualifierVal niet worden gebruikt.
WBEM_FLAG_ONLY_IF_TRUE	1	Alleen eigenschappen retourneren die een kwalificatie hebben van de naam die is opgegeven door de strQualifierName parameter. Als deze vlag wordt gebruikt, moet u opgeven strQualifierName.
WBEM_FLAG_ONLY_IF_FALSE	2	Alleen eigenschappen retourneren die geen kwalificatie hebben van de naam die is opgegeven door de strQualifierName parameter. Als deze vlag wordt gebruikt, moet u opgeven strQualifierName.
WBEM_FLAG_ONLY_IF_IDENTICAL	3	Alleen eigenschappen retourneren die een kwalificatie hebben van de naam die is opgegeven door de wszQualifierName parameter en die ook een waarde hebben die identiek is aan de waarde die is opgegeven door de pQualifierVal structuur. Als deze vlag wordt gebruikt, moet u zowel een als een wszQualifierNamepQualifierValueopgeven.

Groep 2-vlaggen	Waarde	Beschrijving
WBEM_FLAG_KEYS_ONLY	0x4	Retourneert alleen de namen van eigenschappen die de sleutels definiëren.
WBEM_FLAG_REFS_ONLY	0x8	Retourneer alleen eigenschapsnamen die objectverwijzingen zijn.

Groep 3-vlaggen	Waarde	Beschrijving
WBEM_FLAG_LOCAL_ONLY	0x10	Alleen eigenschapsnamen retourneren die tot de meest afgeleide klasse behoren. Eigenschappen uitsluiten van de bovenliggende klassen.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Retourneer alleen eigenschapsnamen die behoren tot de bovenliggende klassen.
WBEM_FLAG_SYSTEM_ONLY	0x30	Retourneert alleen de namen van systeemeigenschappen.
WBEM_FLAG_NONSYSTEM_ONLY	0x40	Retourneer alleen de namen van niet-systeemeigenschappen.

De functie wijst altijd een nieuwe SAFEARRAY toe als deze retourneert WBEM_S_NO_ERRORen pstrNames is altijd ingesteld om ernaar te verwijzen. De geretourneerde matrix kan 0 elementen bevatten als er geen eigenschappen overeenkomen met de opgegeven filters. Als de functie een andere waarde dan WBM_S_NO_ERRORretourneert, wordt er geen nieuwe SAFEARRAY structuur geretourneerd.

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)