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 |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |