ResUtilSetExpandSzValue 函式 (resapi.h)
設定叢集資料庫中可展開的字串值。 PRESUTIL_SET_EXPAND_SZ_VALUE類型會定義此函式的指標。
語法
DWORD ResUtilSetExpandSzValue(
[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。
如果作業失敗，函式會傳回 系統錯誤碼。 以下是可能的錯誤碼。
| 傳回碼 | Description |
|---|---|
|
嘗試配置記憶體時發生錯誤。 |
備註
ResUtilSetExpandSzValue 公用程式函式會配置新值的記憶體，並呼叫 Cluster API 函式 ClusterRegSetValue。
可展開的字串值包含代表 Null 終止的 Unicode 字串的數據，其中包含未展開的環境變數參考，例如 「%SystemRoot%」。
請務必在 *ppszOutValue 上呼叫 LocalFree，以避免記憶體流失。
請勿從下列資源 DLL 進入點函式呼叫 ResUtilSetExpandSzValue ：
ResUtilSetExpandSzValue 可以從任何其他資源 DLL 進入點函式或背景工作線程安全地呼叫。 如需詳細資訊，請參閱 在資源 DLL 中避免的函式呼叫。規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 目標平台 | Windows |
| 標頭 | resapi.h |
| 程式庫 | ResUtils.lib |
| Dll | ResUtils.dll |