CfReferenceProtectedHandle 関数 (cfapi.h)

  • [アーティクル]

呼び出し元が保護されたハンドルを、CfApi 以外の Win32 API で使用できる Win32 ハンドルに参照できるようにします。

構文

BOOLEAN CfReferenceProtectedHandle(
  [in] HANDLE ProtectedHandle
);

パラメーター

[in] ProtectedHandle

プレースホルダー ファイルの保護されたハンドル。

戻り値

この関数が成功すると、 が返されます TRUE。 それ以外の場合は、 FALSEを返します。

注釈

すべての CfReferenceProtectedHandle 呼び出しは、CfReleaseProtectedHandle 呼び出しと一致する必要があります。 保護されたハンドルを長期間参照することはお勧めしません。これにより、oplock の中断通知が確認されなくなります。

呼び出し元は、代わりに実行時間の長いタスクをより小さなサブタスクに分割し、各サブタスクの保護されたハンドルを参照/解放する必要があります。

要件

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

関連項目

CfReleaseProtectedHandle