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