PrjDeleteFile 関数 (projectedfslib.h)

プロバイダーがローカル ファイル システムにキャッシュされている項目を削除できるようにします。

構文

HRESULT PrjDeleteFile(
  [in]            PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [in]            PCWSTR                               destinationFileName,
  [in, optional]  PRJ_UPDATE_TYPES                     updateFlags,
  [out, optional] PRJ_UPDATE_FAILURE_CAUSES            *failureReason
);

パラメーター

[in] namespaceVirtualizationContext

仮想化インスタンスの不透明なハンドル。

[in] destinationFileName

削除するファイルまたはディレクトリへの仮想化ルートを基準とするパスを指定する、null で終わる Unicode 文字列。

[in, optional] updateFlags

削除操作を制御するフラグは、ファイルの状態を指定して許可する必要があります。

[out, optional] failureReason

削除が失敗した理由を説明するコードを受け取るオプションのポインター。

戻り値

HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_VIRTUALIZATION_INVALID_OPERATION) エラーが返された場合、アイテムの状態と updateFlags の値が原因で更新に失敗しました。 failureReason を指定すると、エラーの理由が記述されます。

注釈

項目がまだプロバイダーのバッキング ストアにある場合は、ローカル ファイル システムからアイテムを削除すると、仮想アイテムに変更されます。

このルーチンは、仮想ファイル/ディレクトリで呼び出すことはできません。

削除するファイル/ディレクトリが "placeholder" 以外の状態の場合、プロバイダーは updateFlags パラメーターに PRJ_UPDATE_TYPES 値の適切な組み合わせを指定する必要があります。 これは、データの偶発的な損失を防ぐために役立ちます。

Requirements