CfGetCorrelationVector 関数 (cfapi.h)

同期プロバイダーが、特定のプレースホルダーファイルに対して現在の相関ベクトルに対してクエリを実行できるようにします。これは、ファイルが最初に開かれたときにプラットフォームによって自動的に割り当てられるか、 CfSetCorrelationVector を介して明示的に割り当てられます。

構文

HRESULT CfGetCorrelationVector(
  [in]  HANDLE              FileHandle,
  [out] PCORRELATION_VECTOR CorrelationVector
);

[in] FileHandle

プレースホルダーファイルへのハンドル。プラットフォームは、操作を他のアクティブな要求と適切に同期します。属性またはアクセスなしのハンドルで十分です。

[out] CorrelationVector

FileHandle に現在関連付けられている相関ベクトル。

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

呼び出し 元は、 READ_DATAまたはプレースホルダーへの WRITE_DAC アクセス権を持っている必要があります。それ以外の場合、 操作はSTATUS_CLOUD_FILE_ACCESS_DENIEDで失敗します。