CM_Set_Device_Interface_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_Device_Interface_Property .]

Die CM_Set_Device_Interface_Property_ExW-Funktion legt eine Geräteeigenschaft einer Geräteschnittstelle fest.

Syntax

CMAPI CONFIGRET CM_Set_Device_Interface_Property_ExW(
  [in]           LPCWSTR          pszDeviceInterface,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           DEVPROPTYPE      PropertyType,
  [in]           const PBYTE      PropertyBuffer,
  [in]           ULONG            PropertyBufferSize,
  [in]           ULONG            ulFlags,
  [in, optional] HMACHINE         hMachine
);

Parameter

[in] pszDeviceInterface

Zeiger auf eine Zeichenfolge, die die Geräteschnittstelle identifiziert, instance für die eine Eigenschaft festgelegt werden soll.

[in] PropertyKey

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

[in] PropertyType

Ein DEVPROPTYPE-typisierter Wert, der den Bezeichner property-data-type für die Geräteschnittstelleneigenschaft darstellt. Um eine Eigenschaft zu löschen, muss diese auf DEVPROP_TYPE_EMPTY festgelegt werden.

[in] PropertyBuffer

Zeiger auf einen Puffer, der den Eigenschaftswert der Geräteschnittstelleneigenschaft enthält. Wenn entweder die Eigenschaft oder die Daten gelöscht werden, muss dieser Zeiger auf NULL festgelegt werden, und PropertyBufferSize muss auf 0 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

Reserviert. Muss auf 0 festgelegt werden.

[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_Device_Interface_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

SetupDiSetDeviceInterfaceProperty

Freigeben über