SwDevicePropertySet 関数 (swdevice.h)

ソフトウェア デバイスのプロパティを設定します。

構文

HRESULT SwDevicePropertySet(
  [in] HSWDEVICE         hSwDevice,
  [in] ULONG             cPropertyCount,
  [in] const DEVPROPERTY *pProperties
);

パラメーター

[in] hSwDevice

プロパティを設定するソフトウェア デバイスへの HSWDEVICE ハンドル。

[in] cPropertyCount

pProperties 配列内の DEVPROPERTY 構造体の数。

[in] pProperties

設定するプロパティを含む DEVPROPERTY 構造体の配列。

戻り値

SwDevicePropertySet でプロパティが正常に設定された場合、S_OKが返されます。それ以外の場合は、適切なエラー値。

注釈

SwDevicePropertySet は、オペレーティング システムがクライアント アプリの SW_DEVICE_CREATE_CALLBACK コールバック関数を呼び出して、デバイスの列挙が完了したことをクライアント アプリに通知した後にのみ呼び出すことができます。

SwDeviceCreate 呼び出しの一部として設定されるプロパティと、後で SwDevicePropertySet を呼び出して設定されるプロパティには微妙な違いがあります。 SwDeviceCreate の一部として設定されたプロパティはメモリに格納されます。デバイスがアンインストールされた場合、または null ドライバーによってプロパティ ストアが消去された場合、PnP がデバイスを再列挙すると、これらのプロパティはソフトウェア デバイス API 機能によって再び書き出されます。 これはすべてクライアントに対して透過的です。 列挙後 に SwDevicePropertySet を使用して設定されたプロパティは、メモリに保持されません。 ただし、 SwDeviceCreate を使用してプロパティを設定した場合は、 SwDevicePropertySet を使用して値を更新できます。この更新プログラムは、メモリ内の値と永続化されたストアに適用されます。

SwDevicePropertySet は、デバイスのオペレーティング システム ストアのプロパティを設定する場合にのみ使用できます。

要件

要件	値
サポートされている最小のクライアント	Windows 8
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	ユニバーサル
Header	swdevice.h
Library	Swdevice.lib;Windows 10の OneCoreUAP.lib
[DLL]	Cfgmgr32.dll