CM_Set_Class_Property_ExW-Funktion (cfgmgr32.h)

Artikel
08/22/2023

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Set_Class_Property .]

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

Syntax

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

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.

[in, optional] hMachine

Vom Anrufer bereitgestellter Maschinenhandle, der aus einem vorherigen Aufruf von CM_Connect_Machine abgerufen wurde.

Hinweis Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.

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_ExW ist Teil des Unified Device-Eigenschaftsmodells.

Anforderungen


Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 10 und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek	Cfgmgr32.lib

Weitere Informationen

CM_Connect_Machine

SetupDiSetClassProperty

Freigeben über