CM_Get_DevNode_Property_ExW-Funktion (cfgmgr32.h)
[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Get_DevNode_Property .]
Die CM_Get_DevNode_Property_ExW-Funktion ruft eine Geräte-instance-Eigenschaft ab.
Syntax
CMAPI CONFIGRET CM_Get_DevNode_Property_ExW(
[in] DEVINST dnDevInst,
[in] const DEVPROPKEY *PropertyKey,
[out] DEVPROPTYPE *PropertyType,
[out] PBYTE PropertyBuffer,
[in, out] PULONG PropertyBufferSize,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parameter
[in] dnDevInst
Gerät instance Handle, das an den lokalen Computer gebunden ist.
[in] PropertyKey
Zeiger auf eine DEVPROPKEY-Struktur, die den Geräteeigenschaftsschlüssel des angeforderten Geräts instance-Eigenschaft darstellt.
[out] PropertyType
Zeiger auf eine VARIABLE vom Typ DEVPROPTYPE, die den Property-Data-Type-Bezeichner des angeforderten Geräts instance Eigenschaft empfängt, wobei der Eigenschaftsdatentypbezeichner der bitweise OR zwischen einem Basisdatentypbezeichner und, wenn der Basisdatentyp geändert wird, einem Property-Data-Type-Modifizierer entspricht.
[out] PropertyBuffer
Zeiger auf einen Puffer, der das angeforderte Gerät instance -Eigenschaft empfängt. CM_Get_DevNode_Property_ExW ruft die angeforderte Eigenschaft 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 PropertyBuffer auf NULL festgelegt ist, muss *PropertyBufferSize auf null festgelegt werden. Wenn der Puffer nicht groß genug ist, um alle Eigenschaftswertdaten aufzunehmen, gibt CM_Get_DevNode_Property_ExW die Größe der Daten in Bytes in *PropertyBufferSize zurück.
[in] ulFlags
Reserviert. Muss auf 0 (null) festgelegt werden.
[in, optional] 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_DevNode_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 |