共用方式為


CM_Set_DevNode_Property_ExW函式 (cfgmgr32.h)

[從 Windows 8 和 Windows Server 2012 開始,此函式已被取代。 請改用 CM_Set_DevNode_Property 。]

CM_Set_DevNode_Property_ExW函式會設定裝置實例屬性。

語法

CMAPI CONFIGRET CM_Set_DevNode_Property_ExW(
  [in]           DEVINST          dnDevInst,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           DEVPROPTYPE      PropertyType,
  [in]           const PBYTE      PropertyBuffer,
  [in]           ULONG            PropertyBufferSize,
  [in]           ULONG            ulFlags,
  [in, optional] HMACHINE         hMachine
);

參數

[in] dnDevInst

系結至本機計算機的裝置實例句柄。

[in] PropertyKey

DEVPROPKEY 結構的指標,代表要設定之裝置實例屬性的屬性索引鍵。

[in] PropertyType

DEVPROPTYPE 型別值,代表裝置實例屬性的屬性數據類型標識碼。 若要刪除屬性,這必須設定為 DEVPROP_TYPE_EMPTY。

[in] PropertyBuffer

緩衝區的指標,其中包含裝置實例屬性的屬性值。 如果屬性或正在刪除數據,此指標必須設定為 NULL, 而且 PropertyBufferSize 必須設定為零。

[in] PropertyBufferSize

PropertyBuffer 緩衝區的大小,以位元組為單位。 如果 PropertyBuffer 設定為 NULL,PropertyBufferSize 必須設定為零。

[in] ulFlags

保留的。 必須設定為零。

[in, optional] hMachine

呼叫端提供的機器句柄,是從先前呼叫 CM_Connect_Machine取得。

注意從 Windows 8 和 Windows Server 2012 開始,不支援使用此函式來存取遠端計算機,因為此功能已移除。
 

傳回值

如果作業成功,函式會傳回CR_SUCCESS。 否則,它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。

備註

CM_Set_DevNode_Property_ExW整合裝置屬性模型的一部分。

規格需求

需求
最低支援的用戶端 可在 Microsoft Windows 10 和更新版本的 Windows 中使用。
目標平台 桌面
標頭 cfgmgr32.h (包含 Cfgmgr32.h)
程式庫 Cfgmgr32.lib

另請參閱

CM_Connect_Machine

SetupDiSetDeviceProperty