CM_Get_Class_PropertyW-Funktion (cfgmgr32.h)
Die CM_Get_Class_Property-Funktion ruft eine Geräteeigenschaft ab, die für eine Geräteschnittstellenklasse oder Geräteeinrichtungsklasse festgelegt ist.
Syntax
CMAPI CONFIGRET CM_Get_Class_PropertyW(
[in] LPCGUID ClassGUID,
[in] const DEVPROPKEY *PropertyKey,
[out] DEVPROPTYPE *PropertyType,
[out] PBYTE PropertyBuffer,
[in, out] PULONG PropertyBufferSize,
[in] ULONG ulFlags
);
Parameter
[in] ClassGUID
Zeiger auf die GUID, die die Geräteschnittstellenklasse oder Gerätesetupklasse identifiziert, für die eine für die Geräteklasse festgelegte Geräteeigenschaft abgerufen werden soll. Informationen zum Angeben des Klassentyps finden Sie im UlFlags-Parameter .
[in] PropertyKey
Zeiger auf eine DEVPROPKEY-Struktur , die den Geräteeigenschaftsschlüssel der angeforderten Geräteklasseneigenschaft darstellt.
[out] PropertyType
Zeiger auf eine DEVPROPTYPE-typisierte Variable, die den Property-Data-Type-Bezeichner der angeforderten Geräteklasseneigenschaft empfängt, wobei der Property-Data-Type-Bezeichner der bitweise OR zwischen einem Basisdatentypbezeichner und, wenn der Basisdatentyp geändert wird, einem Eigenschaft-Datentyp-Modifizierer ist.
[out] PropertyBuffer
Zeiger auf einen Puffer, der die angeforderte Geräteklasseneigenschaft empfängt. CM_Get_Class_Property ruft den angeforderten Eigenschaftswert nur ab, wenn der Puffer groß genug ist, um alle Eigenschaftenwertdaten zu enthalten. Der Zeiger kann NULL sein.
[in, out] PropertyBufferSize
Die Größe des PropertyBuffer-Puffers in Bytes. Wenn der PropertyBuffer-Parameter auf NULL festgelegt ist, muss *PropertyBufferSize auf null festgelegt werden. Wenn der Puffer nicht groß genug ist, um alle Eigenschaftswertdaten aufzunehmen, gibt CM_Get_Class_Property als Ausgabe die Größe der Daten in Bytes in *PropertyBufferSize zurück.
[in] ulFlags
Klasseneigenschaftsflags:
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.
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 ist Teil des einheitlichen Geräteeigenschaftenmodells.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows Vista und höheren Versionen von Windows. |
| Zielplattform | Universell |
| Header | cfgmgr32.h (include Cfgmgr32.h) |
| Bibliothek | Cfgmgr32.lib |