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を返します。
操作が失敗した場合、関数は システム エラー コードを返します。 考えられるエラー コードを次に示します。
| リターン コード | 説明 |
|---|---|
|
メモリの割り当て中にエラーが発生しました。 |
注釈
ResUtilSetExpandSzValue ユーティリティ関数は、新しい値にメモリを割り当て、Cluster API 関数 ClusterRegSetValue を呼び出します。
展開可能な文字列値には、"%SystemRoot%" などの環境変数への未拡張の参照を含む null で終わる Unicode 文字列を表すデータが含まれています。
メモリ リークを回避するには、必ず *ppszOutValue で LocalFree を呼び出してください。
次のリソース DLL エントリ ポイント関数から ResUtilSetExpandSzValue を呼び出さないでください。
ResUtilSetExpandSzValue は、他のリソース DLL エントリ ポイント関数またはワーカー スレッドから安全に呼び出すことができます。 詳細については、「 リソース DLL での回避する関数呼び出し」を参照してください。要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |