CM_Get_DevNode_Property_Keys-Funktion (cfgmgr32.h)

Die funktion CM_Get_DevNode_Property_Keys ruft ein Array der Geräteeigenschaftsschlüssel ab, die die Geräteeigenschaften darstellen, die für ein Gerät instance festgelegt sind.

Syntax

CMAPI CONFIGRET CM_Get_DevNode_Property_Keys(
  [in]            DEVINST    dnDevInst,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags
);

Parameter

[in] dnDevInst

Gerät instance Handle, das an den lokalen Computer gebunden ist.

[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 das Gerät instance 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_DevNode_Property_Keys 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_DevNode_Property_Keys ist Teil des einheitlichen Geräteeigenschaftenmodells.

Anforderungen

Weitere Informationen

SetupDiGetDevicePropertyKeys