クラスター データベースから不明なプロパティのセットを取得し、プロパティ リストの末尾に追加します。
構文
DWORD ResUtilAddUnknownProperties(
[in] HKEY hkeyClusterKey,
[in] const PRESUTIL_PROPERTY_ITEM pPropertyTable,
[in, out] PVOID pOutPropertyList,
[in] DWORD pcbOutPropertyListSize,
[in, out] LPDWORD pcbBytesReturned,
[in, out] LPDWORD pcbRequired
);
パラメーター
[in] hkeyClusterKey
読み取るプロパティの場所を識別するクラスター データベース キーへのポインター。
[in] pPropertyTable
オブジェクトの共通 プロパティ とプライベート プロパティを記述するプロパティ テーブルへのポインター。 このプロパティ テーブルにないクラスター データベースで見つかったプロパティは、プロパティ リストに追加されます。
[in, out] pOutPropertyList
返されたプロパティを受け取るバッファーへのポインター。 入力時に、バッファーに既存のプロパティ リストを含めたり、空にしたりできます。 出力時に、取得したプロパティは既存のリストの末尾に追加されます。バッファーが空の場合は、新しいプロパティ リストとして返されます。
[in] pcbOutPropertyListSize
pOutPropertyList が指すバッファーの合計バイト サイズ。 バッファーのサイズは、既存のプロパティ リストと返されるプロパティ リストを格納するのに十分な大きさである必要があります。
[in, out] pcbBytesReturned
入力時に、pOutPropertyList バッファーに含まれるプロパティ リストのバイト サイズへのポインター。 出力時に、 pOutPropertyList が指すプロパティ リスト内の合計バイト数へのポインター。
[in, out] pcbRequired
出力時に、返されるプロパティ リストを保持するために必要な合計バイト数をポイントします。 pOutPropertyList バッファーが小さすぎる場合は、必要なサイズに再割り当てできます。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は システム エラー コードを返します。 考えられるエラー コードを次に示します。
| リターン コード | 説明 |
|---|---|
|
メモリの割り当て中にエラーが発生しました。 |
注釈
ResUtilAddUnknownProperties の入力パラメーターと出力パラメーターの関係を次の図に示します。
ResUtilAddUnknownProperties ユーティリティ関数は、クラスター データベース (hkeyClusterKey の下) に格納されているプロパティを列挙し、プロパティ テーブル (pPropertyTable) で対応するプロパティを検索します。 クラスター データベースに一覧表示されているが、プロパティ テーブルにリストされていない各プロパティは、プロパティ リスト (pOutPropertyList) に追加されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |