CM_Set_Device_Interface_PropertyW-Funktion (cfgmgr32.h)
Die CM_Set_Device_Interface_Property-Funktion legt eine Geräteeigenschaft einer Geräteschnittstelle fest.
Syntax
CMAPI CONFIGRET CM_Set_Device_Interface_PropertyW(
[in] LPCWSTR pszDeviceInterface,
[in] const DEVPROPKEY *PropertyKey,
[in] DEVPROPTYPE PropertyType,
[in] const PBYTE PropertyBuffer,
[in] ULONG PropertyBufferSize,
[in] ULONG ulFlags
);
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.
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 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 |