PrjFillDirEntryBuffer 関数 (projectedfslib.h)

列挙体に対する 1 つのファイルまたはディレクトリの情報を提供します。

構文

HRESULT PrjFillDirEntryBuffer(
  [in]           PCWSTR                      fileName,
  [in, optional] PRJ_FILE_BASIC_INFO         *fileBasicInfo,
  [in]           PRJ_DIR_ENTRY_BUFFER_HANDLE dirEntryBufferHandle
);

パラメーター

[in] fileName

エントリの名前を含む null で終わる文字列へのポインター

[in, optional] fileBasicInfo

入力するエントリに関する基本情報。

[in] dirEntryBufferHandle

塗りつぶされたエントリに関する情報を受け取る構造体への不透明なハンドル。

戻り値

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) は、dirEntryBufferHandle に新しいエントリ用の十分な領域がないことを示します。

注釈

プロバイダーは、このルーチンを使用して 、PRJ_GET_DIRECTORY_ENUMERATION_CB コールバックを処理します。 コールバックを処理するときに、プロバイダーは列挙体内の一致するファイルまたはディレクトリごとにこのルーチンを呼び出します。

このルーチンが列挙型にエントリを追加するときに HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) を返す場合、プロバイダーはコールバックからS_OKを返し、次の PRJ_GET_DIRECTORY_ENUMERATION_CB コールバックを待機します。

プロバイダーは、HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) になったときに追加しようとしていたエントリで列挙体の入力を再開します。

このルーチンが、PRJ_GET_DIRECTORY_ENUMERATION_CBコールバックの呼び出し中に追加された最初のエントリの HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER )を返す場合、プロバイダーはコールバックからHRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)を返す必要があります。

Requirements