CfRevertPlaceholder 関数 (cfapi.h)

プレースホルダーを通常のファイルに戻し、再解析タグ、ファイル ID などの特殊な特性をすべて取り除きます。

構文

HRESULT CfRevertPlaceholder(
  [in]                HANDLE          FileHandle,
  [in]                CF_REVERT_FLAGS RevertFlags,
  [in, out, optional] LPOVERLAPPED    Overlapped
);

パラメーター

[in] FileHandle

通常のファイルまたはディレクトリに戻されようとしているファイルまたはディレクトリ プレースホルダーへのハンドル。 プラットフォームは、元に戻す操作を他のアクティブな要求と適切に同期します。 属性またはアクセスなしのハンドルで十分です。

[in] RevertFlags

プレースホルダーの元に戻すフラグ。 RevertFlags は CF_REVERT_FLAG_NONEに設定する必要があります。

[in, out, optional] Overlapped

指定し、非同期 の FileHandle と組み合わせると、 Overlapped を使用すると、プラットフォームは CfRevertPlaceholder 呼び出しを非同期的に実行できます。 詳細については、「 解説 」を参照してください。

指定しない場合、プラットフォームは、ハンドルの作成方法に関係なく、API 呼び出しを同期的に実行します。

戻り値

この関数が成功すると、 が返されます S_OK。 そうでない場合は、HRESULT エラー コードを返します。

注釈

元に戻すには、呼び出し 元にプレースホルダー への WRITE_DATAまたはWRITE_DAC アクセス権が必要です。

呼び出し時にプレースホルダーがまだ完全にハイドレートされていない場合、フィルターは同期プロバイダーに FETCH_DATA コールバックを送信してファイルをハイドレートします。 ファイルをハイドレートできない場合、元に戻す操作は状態 STATUS_CLOUD_FILE_ACCESS_DENIEDで失敗します。

非同期的に Overlapped を使用しているときに API から HRESULT_FROM_WIN32(ERROR_IO_PENDING) が返された場合、呼び出し元は GetOverlappedResult を使用して待機できます。

要件

要件	値
サポートされている最小のクライアント	Windows 10、バージョン 1709 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	cfapi.h
Library	CldApi.lib
[DLL]	CldApi.dll

こちらもご覧ください

GetOverlappedResult

CF_REVERT_FLAGS