Win32 API 日本語リファレンス
ホーム › Storage.ProjectedFileSystem › PRJ_START_DIRECTORY_ENUMERATION_CB

PRJ_START_DIRECTORY_ENUMERATION_CB

コールバック

シグネチャ

HRESULT PRJ_START_DIRECTORY_ENUMERATION_CB(
    PRJ_CALLBACK_DATA* callbackData,
    GUID* enumerationId
);

パラメーター

フィールド型説明
callbackDataPRJ_CALLBACK_DATA*

操作に関する情報です。このコールバックを実装するには、次の callbackData メンバーが必要です。

FilePathName 列挙するディレクトリを示します。
VersionInfo 列挙するディレクトリのバージョン情報を提供します。

プロバイダーがこのバッファーにアクセスできるのは、コールバックの実行中のみです。操作を保留し、このバッファー内のデータが必要な場合は、プロバイダー自身でコピーを作成する必要があります。

enumerationIdGUID*この列挙セッションの識別子です。

公式ドキュメント

ディレクトリの列挙が開始されることをプロバイダーに通知します。

戻り値

戻り値 説明
S_OK
 プロバイダーは操作を正常に完了しました。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
 列挙するディレクトリが、プロバイダーのバッキングストアに存在しません。
HRESULT_FROM_WIN32(ERROR_IO_PENDING)
 プロバイダーは、後で操作を完了することを希望しています。

プロバイダーが操作に失敗した場合は、適切な HRESULT エラーコード。

解説(Remarks)

ProjFS は、まずこのコールバックを呼び出し、続いて 1 つ以上の PRJ_GET_DIRECTORY_ENUMERATION_CB コールバック、最後に PRJ_END_DIRECTORY_ENUMERATION_CB コールバックを呼び出すことで、プロバイダーにディレクトリの列挙を要求します。同じ場所で複数の列挙が並行して行われることがあるため、ProjFS は enumerationId 引数を使用して、コールバックの呼び出しを 1 つの列挙セッションに関連付けます。つまり、列挙コールバックへの一連の呼び出しでは、同じセッションに対して enumerationId に同じ値が使用されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)