クラスター データベースから文字列値を返します。
構文
LPWSTR ResUtilGetSzValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName
);
パラメーター
[in] hkeyClusterKey
クラスター データベース内の値の場所を識別するキー。
[in] pszValueName
取得する値の名前を含む null で終わる Unicode 文字列。
戻り値
操作が成功した場合、関数は文字列値を含むバッファーへのポインターを返します。
操作が失敗した場合、関数は NULL を返します。 詳細については、 GetLastError 関数を呼び出します。
注釈
ResUtilGetSzValue ユーティリティ関数は、クラスター API 関数 ClusterRegQueryValue を呼び出してクラスター データベースにアクセスする前に、文字列パラメーター値に必要なメモリを割り当てます。 このメモリが終了したら、 LocalFree 関数を呼び出して解放する必要があります。
ResUtilGetSzValue では、拡張可能な文字列形式と複数の文字列形式もサポートされています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |