CM_Set_DevNode_PropertyW-Funktion (cfgmgr32.h)

Die CM_Set_DevNode_Property-Funktion legt eine Geräte-instance-Eigenschaft fest.

Syntax

CMAPI CONFIGRET CM_Set_DevNode_PropertyW(
  [in] DEVINST          dnDevInst,
  [in] const DEVPROPKEY *PropertyKey,
  [in] DEVPROPTYPE      PropertyType,
  [in] const PBYTE      PropertyBuffer,
  [in] ULONG            PropertyBufferSize,
  [in] ULONG            ulFlags
);

Parameter

[in] dnDevInst

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

[in] PropertyKey

Zeiger auf eine DEVPROPKEY-Struktur, die den Eigenschaftenschlüssel des festzulegenden Geräts instance Eigenschaft darstellt.

[in] PropertyType

Ein DEVPROPTYPE-typisierter Wert, der den Property-Data-Type-Bezeichner für das Gerät instance-Eigenschaft darstellt. Um eine Eigenschaft zu löschen, muss diese auf DEVPROP_TYPE_EMPTY festgelegt werden.

[in] PropertyBuffer

Zeiger auf einen Puffer, der den Eigenschaftswert des Geräts instance -Eigenschaft enthält. Wenn entweder die Eigenschaft oder die Daten gelöscht werden, muss dieser Zeiger auf NULL und PropertyBufferSize auf Null festgelegt werden.

[in] PropertyBufferSize

Die Größe des PropertyBuffer-Puffers in Bytes. Wenn PropertyBuffer auf NULL festgelegt ist, muss PropertyBufferSize auf Null festgelegt werden.

[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_Set_DevNode_Property ist Teil des einheitlichen Geräteeigenschaftenmodells.

Anforderungen

Weitere Informationen

SetupDiSetDeviceProperty