CM_Set_Class_PropertyW-Funktion (cfgmgr32.h)

Artikel
02/26/2024

Die CM_Set_Class_Property-Funktion legt eine Klasseneigenschaft für eine Geräteeinrichtungsklasse oder eine Geräteschnittstellenklasse fest.

Syntax

CMAPI CONFIGRET CM_Set_Class_PropertyW(
  [in] LPCGUID          ClassGUID,
  [in] const DEVPROPKEY *PropertyKey,
  [in] DEVPROPTYPE      PropertyType,
  [in] const PBYTE      PropertyBuffer,
  [in] ULONG            PropertyBufferSize,
  [in] ULONG            ulFlags
);

Parameter

[in] ClassGUID

Zeiger auf die GUID, die die Geräteschnittstellenklasse oder Geräteeinrichtungsklasse identifiziert, für die eine Geräteeigenschaft festgelegt werden soll. Informationen zum Angeben des Klassentyps finden Sie im ulFlags-Parameter .

[in] PropertyKey

Zeiger auf eine DEVPROPKEY-Struktur , die den Eigenschaftenschlüssel der festzulegenden Geräteklasseneigenschaft darstellt.

[in] PropertyType

Ein DEVPROPTYPE-typisierter Wert, der den Eigenschaftsdatentypbezeichner für die Geräteklasseneigenschaft darstellt. Um eine Eigenschaft zu löschen, legen Sie diese auf DEVPROP_TYPE_EMPTY fest.

[in] PropertyBuffer

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

[in] PropertyBufferSize

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

[in] ulFlags

Klasseneigenschaftsflags:

CM_CLASS_PROPERTY_INSTALLER

ClassGUID gibt eine Geräteeinrichtungsklasse 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.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der CR_-Präfix-Fehlercodes zurückgegeben, die in Cfgmgr32.h definiert sind.

Hinweise

CM_Set_Class_Property ist Teil des Unified Device-Eigenschaftsmodells.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows Vista und höheren Versionen von Windows.
Zielplattform	Universell
Header	cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek	Cfgmgr32.lib

Weitere Informationen

SetupDiSetClassProperty

Freigeben über