CM_Get_Class_Property_ExW-Funktion (cfgmgr32.h)
[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Get_Class_Property .]
Die CM_Get_Class_Property_ExW-Funktion ruft eine Geräteeigenschaft ab, die für eine Geräteschnittstellenklasse oder Geräteeinrichtungsklasse festgelegt ist.
Syntax
CMAPI CONFIGRET CM_Get_Class_Property_ExW(
[in] LPCGUID ClassGUID,
[in] const DEVPROPKEY *PropertyKey,
[out] DEVPROPTYPE *PropertyType,
[out] PBYTE PropertyBuffer,
[in, out] PULONG PropertyBufferSize,
[in] ULONG ulFlags,
[in] HMACHINE hMachine
);
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_ExW ruft den angeforderten Eigenschaftswert nur ab, wenn der Puffer groß genug ist, um alle Eigenschaftswertdaten 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_ExW 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.
[in] hMachine
Vom Aufrufer bereitgestellter Maschinenhandle, der aus einem vorherigen Aufruf von CM_Connect_Machine abgerufen 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_ExW ist Teil des einheitlichen Geräteeigenschaftenmodells.
Anforderungen
| 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 |