SetupDiSetDevicePropertyW-Funktion (setupapi.h)

Artikel
08/26/2023

Die SetupDiSetDeviceProperty-Funktion legt ein Gerät instance-Eigenschaft fest.

Syntax

WINSETUPAPI BOOL SetupDiSetDevicePropertyW(
  [in]           HDEVINFO         DeviceInfoSet,
  [in]           PSP_DEVINFO_DATA DeviceInfoData,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           DEVPROPTYPE      PropertyType,
  [in, optional] const PBYTE      PropertyBuffer,
  [in]           DWORD            PropertyBufferSize,
  [in]           DWORD            Flags
);

Parameter

[in] DeviceInfoSet

Ein Handle für einen Geräteinformationssatz. Dieser Geräteinformationssatz enthält ein Geräteinformationselement, das das gerät instance darstellt, für das ein Gerät instance Eigenschaft festgelegt werden soll.

[in] DeviceInfoData

Ein Zeiger auf die SP_DEVINFO_DATA Struktur, die das Gerät identifiziert, instance für das ein Gerät instance Eigenschaft festgelegt werden soll.

[in] PropertyKey

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

[in] PropertyType

Ein DEVPROPTYPE-typisierter Wert, der den Eigenschaftsdatentypbezeichner für das Gerät instance-Eigenschaft darstellt. Weitere Informationen finden Sie weiter unten in diesem Thema im Abschnitt Hinweise .

[in, optional] PropertyBuffer

Ein Zeiger auf einen Puffer, der das Gerät instance Eigenschaftswert enthält. Wenn die Eigenschaft gelöscht oder auf einen NULL-Wert festgelegt wird, muss dieser Zeiger NULL sein, und PropertyBufferSize muss auf Null festgelegt werden.

[in] PropertyBufferSize

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

[in] Flags

Dieser Parameter muss auf 0 festgelegt werden.

Rückgabewert

Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann durch Aufrufen von GetLastError abgerufen werden.

Die folgende Tabelle enthält einige der häufigeren Fehlercodes, die diese Funktion möglicherweise protokolliert.

Rückgabecode	Beschreibung
ERROR_INVALID_FLAGS	Der Wert von Flags ist nicht 0.
ERROR_INVALID_HANDLE	Der von DevInfoSet angegebene Geräteinformationssatz ist ungültig.
ERROR_INVALID_PARAMETER	Ein bereitgestellter Parameter ist ungültig. Eine Möglichkeit besteht darin, dass das Geräteinformationselement ungültig ist.
ERROR_INVALID_REG_PROPERTY	Der von PropertyKey bereitgestellte Eigenschaftenschlüssel ist ungültig, oder die Eigenschaft kann nicht beschreibbar sein.
ERROR_INVALID_DATA	Der von PropertyType bereitgestellte Eigenschaftsdatentypbezeichner oder der von PropertyBuffer bereitgestellte Eigenschaftswert ist ungültig.
ERROR_INVALID_USER_BUFFER	Ein Benutzerpuffer ist ungültig. Eine Möglichkeit besteht darin, dass PropertyBufferNULL und PropertyBufferSize nicht 0 ist.
ERROR_NO_SUCH_DEVINST	Das gerät instance, das von DevInfoData angegeben wird, ist nicht vorhanden.
ERROR_INSUFFICIENT_BUFFER	Ein interner Datenpuffer, der an einen Systemaufruf übergeben wurde, war zu klein.
ERROR_NOT_ENOUGH_MEMORY	Es war nicht genügend Systemspeicher verfügbar, um den Vorgang abzuschließen.
ERROR_NOT_FOUND	Ein nicht angegebenes internes Element wurde nicht gefunden. Eine Möglichkeit besteht darin, dass die zu löschende Eigenschaft nicht vorhanden ist.
ERROR_ACCESS_DENIED	Der Aufrufer verfügt nicht über Administratorrechte.

Hinweise

SetupDiSetDeviceProperty ist Teil des einheitlichen Geräteeigenschaftenmodells.

SetupAPI unterstützt nur eine Unicode-Version von SetupDiSetDeviceProperty.

Ein Aufrufer von SetupDiSetDeviceProperty muss Mitglied der Gruppe Administratoren sein, um ein Gerät instance-Eigenschaft festzulegen.

SetupDiSetDeviceProperty erzwingt Anforderungen für den Bezeichner property-data-type und den Eigenschaftswert.

Um die Geräteeigenschaftenschlüssel für die instance Geräteeigenschaften abzurufen, die für ein Gerät festgelegt sind, rufen Sie SetupDiGetDevicePropertyKeys auf.

Um ein Gerät instance-Eigenschaft abzurufen, rufen Sie SetupDiGetDeviceProperty auf.

Anforderungen


Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und späteren Windows-Versionen.
Zielplattform	DesktopFür universell rufen Sie CM_Set_DevNode_Property auf
Kopfzeile	setupapi.h (einschließlich Setupapi.h)
Bibliothek	Setupapi.lib

Weitere Informationen

SetupDiGetDeviceProperty

SetupDiGetDevicePropertyKeys

Freigeben über