resUtilSetMultiSzValue 函式 (resapi.h)
在 叢集資料庫中設定多個字串值。 PRESUTIL_SET_MULTI_SZ_VALUE類型會定義此函式的指標。
語法
DWORD ResUtilSetMultiSzValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[in] LPCWSTR pszNewValue,
[in] DWORD cbNewValueSize,
[out, optional] LPWSTR *ppszOutValue,
[in, out, optional] LPDWORD pcbOutValueSize
);
參數
[in] hkeyClusterKey
索引鍵，識別叢集資料庫中多個字串值的位置。
[in] pszValueName
Null 終止的 Unicode 字串，其中包含要更新的值名稱。
[in] pszNewValue
新多個字串值的指標。
[in] cbNewValueSize
新值的大小。
[out, optional] ppszOutValue
接收更新值複本之字串指標的指標。 如果使用，呼叫端必須在 *ppszOutValue 上呼叫 LocalFree。
[in, out, optional] pcbOutValueSize
接收新值大小的指標。
傳回值
如果作業成功，函式會傳回 ERROR_SUCCESS。
如果作業失敗，函式會傳回 系統錯誤碼。 以下是可能的錯誤碼。
| 傳回碼 | Description |
|---|---|
|
嘗試配置記憶體時發生錯誤。 |
備註
ResUtilSetMultiSzValue 公用程式函式會配置新值的記憶體，並呼叫 Cluster API 函式 ClusterRegSetValue。
多個字串值是大型字串，其中包含較小的連續、以 Null 結尾的 Unicode 字串，並以最後一個字串之後的額外 Null 字元結尾。
請務必在 *ppszOutValue 上呼叫 LocalFree，以避免記憶體流失。
請勿從下列資源 DLL 進入點函式呼叫 ResUtilSetMultiSzValue ：
ResUtilSetMultiSzValue 可以從任何其他資源 DLL 進入點函式或背景工作線程安全地呼叫。 如需詳細資訊，請參閱 在資源 DLL 中避免的函式呼叫。規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 目標平台 | Windows |
| 標頭 | resapi.h |
| 程式庫 | ResUtils.lib |
| Dll | ResUtils.dll |