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 |