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

PRJ_GET_PLACEHOLDER_INFO_CB

コールバック

シグネチャ

HRESULT PRJ_GET_PLACEHOLDER_INFO_CB(
    PRJ_CALLBACK_DATA* callbackData
);

パラメーター

フィールド型説明
callbackDataPRJ_CALLBACK_DATA*

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

FilePathName ProjFS が情報を要求している、プロバイダーのストア内のファイルまたはディレクトリへのパスを示します。

プロバイダーは、この名前がバッキングストア内に存在するかどうかを判断するためにこれを使用します。ストア内の名前と比較するには、PrjFileNameMatch 関数を使用してください。一致する名前が見つかった場合は、その名前を PrjWritePlaceholderInfo 関数の destinationFileName パラメーターとして使用します。

VersionInfo 要求された項目の親ディレクトリのバージョン情報を提供します。

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

公式ドキュメント

プロバイダーに対して、ファイルまたはディレクトリの情報を要求します。

戻り値

戻り値 説明
S_OK
ファイルはプロバイダーのストアに存在し、そのファイルの情報を ProjFS に正常に渡しました。
HRESULT_FROM_WIN32(ERROR_IO_PENDING)
プロバイダーは、この操作を後で完了することを希望しています。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
ファイルはプロバイダーのストアに存在しません。

プロバイダーが操作を失敗させる場合は、状況に応じた別の HRESULT エラーコードを返します。

解説(Remarks)

ProjFS は、このコールバックで提供された情報を使用して、要求された項目のプレースホルダーを作成します。

このコールバックを処理するには、プロバイダーは PrjWritePlaceholderInfo を呼び出して、要求されたファイル名の情報を ProjFS に渡します。その後、プロバイダーはコールバックを完了します。

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