ResUtilGetAllProperties 関数 (resapi.h)
クラスター オブジェクトのすべての既定のプロパティと不明なプロパティを含むプロパティ リストを返します。 PRESUTIL_GET_ALL_PROPERTIES型は、この関数へのポインターを定義します。
構文
DWORD ResUtilGetAllProperties(
[in] HKEY hkeyClusterKey,
[in] const PRESUTIL_PROPERTY_ITEM pPropertyTable,
[out] PVOID pOutPropertyList,
[in] DWORD cbOutPropertyListSize,
[out] LPDWORD pcbBytesReturned,
[out] LPDWORD pcbRequired
);
パラメーター
[in] hkeyClusterKey
取得するプロパティの場所を識別する クラスター データベース キーへのポインター。
[in] pPropertyTable
取得するプロパティを記述 するRESUTIL_PROPERTY_ITEM 構造体の配列へのポインター。
[out] pOutPropertyList
プロパティ リストを返す出力バッファーへのポインター。
[in] cbOutPropertyListSize
OutBuffer が指す出力バッファーのサイズ (バイト単位)。
[out] pcbBytesReturned
OutBuffer が指すプロパティ リスト内の合計バイト数へのポインター。
[out] pcbRequired
OutBuffer が小さすぎる場合に必要なバイト数へのポインター。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は システム エラー コードを返します。 考えられるエラー コードを次に示します。
リターン コード | 説明 |
---|---|
|
1 つ以上の入力パラメーターが無効でした。 |
|
メモリの割り当て中にエラーが発生しました。 |
|
出力バッファーのサイズが小さすぎて、結果のデータを保持できません。 pcbRequired パラメーターは、正しいサイズを指します。 |
解説
ResUtilGetAllProperties ユーティリティ関数は、次の各プロパティのプロパティ リストにエントリを作成します。
- プロパティ テーブルに含まれます。
- プロパティがプロパティ テーブルに含まれているかどうかに関係なく、ClusterKey パラメーターによって識別されるキーの下のクラスター データベースに含まれます。
要件
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
対象プラットフォーム | Windows |
ヘッダー | resapi.h |
Library | ResUtils.lib |
[DLL] | ResUtils.dll |