CM_Get_Device_Interface_Property_KeysW-Funktion (cfgmgr32.h)
Die CM_Get_Device_Interface_Property_Keys-Funktion ruft ein Array von Geräteeigenschaftenschlüsseln ab, die die Geräteeigenschaften darstellen, die für eine Geräteschnittstelle festgelegt sind.
Syntax
CMAPI CONFIGRET CM_Get_Device_Interface_Property_KeysW(
[in] LPCWSTR pszDeviceInterface,
[out, optional] DEVPROPKEY *PropertyKeyArray,
[in, out] PULONG PropertyKeyCount,
[in] ULONG ulFlags
);
Parameter
[in] pszDeviceInterface
Zeiger auf eine Zeichenfolge, die die Geräteschnittstelle identifiziert, von der instance die Eigenschaftsschlüssel abgerufen werden sollen.
[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äteschnittstelle 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_Device_Interface_Property_Keys als Ausgabe die Anzahl der Schlüssel in *PropertyKeyCount zurück.
[in] ulFlags
Reserviert. Muss auf 0 (null) festgelegt werden.
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_Device_Interface_Property_Keys 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 |