CM_Get_Class_Property_Keys_Ex-Funktion (cfgmgr32.h)

  • Artikel

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Get_Class_Property_Keys .]

Die CM_Get_Class_Property_Keys_Ex-Funktion ruft ein Array der Geräteeigenschaftsschlüssel ab, die die Geräteeigenschaften darstellen, die für eine Geräteschnittstellenklasse oder Geräteeinrichtungsklasse festgelegt sind.

Syntax

CMAPI CONFIGRET CM_Get_Class_Property_Keys_Ex(
  [in]            LPCGUID    ClassGUID,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Parameter

[in] ClassGUID

Zeiger auf die GUID, die die Geräteschnittstellenklasse oder Gerätesetupklasse identifiziert, für die die Eigenschaftenschlüssel abgerufen werden sollen. Informationen zum Angeben des Klassentyps finden Sie im UlFlags-Parameter .

[out, optional] PropertyKeyArray

Zeiger auf einen Puffer, der ein Array von DEVPROPKEY-typisierten Werten empfängt, wobei jeder Wert ein Geräteeigenschaftsschlüssel ist, der eine Geräteeigenschaft darstellt, die für die Geräteklasse festgelegt ist. Der Zeiger ist optional und kann NULL sein.

[in, out] PropertyKeyCount

Die Größe des PropertyKeyArray-Puffers in DEVPROPKEY-typisierten Einheiten. Wenn PropertyKeyArray auf NULL festgelegt ist, muss *PropertyKeyCount auf null festgelegt werden. Wenn PropertyKeyArray nicht groß genug ist, um alle Eigenschaftenschlüsseldaten zu speichern, gibt CM_Get_Class_Property_Keys_Ex als Ausgabe die Anzahl der Schlüssel in *PropertyKeyCount zurück.

[in] ulFlags

Klasseneigenschaftsschlüsselflags:

CM_CLASS_PROPERTY_INSTALLER

ClassGUID gibt eine Gerätesetupklasse an. Nicht mit CM_CLASS_PROPERTY_INTERFACE kombinieren.

CM_CLASS_PROPERTY_INTERFACE

ClassGUID gibt eine Geräteschnittstellenklasse an. Nicht mit CM_CLASS_PROPERTY_INSTALLER kombinieren.

[in, optional] hMachine

Vom Aufrufer bereitgestellter Maschinenhandle, der aus einem vorherigen Aufruf von CM_Connect_Machine abgerufen wurde.

Hinweis Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.
 

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweise

CM_Get_Class_Property_Keys_Ex ist Teil des einheitlichen Geräteeigenschaftenmodells.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 10 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (include Cfgmgr32.h)
Bibliothek Cfgmgr32.lib; OneCoreUAP.lib auf Windows 10
DLL CfgMgr32.dll

Weitere Informationen

CM_Connect_Machine

SetupDiGetClassPropertyKeys

SetupDiGetClassPropertyKeysEx