CfSetCorrelationVector 関数 (cfapi.h)

同期プロバイダーが、プレースホルダー ファイルでテレメトリの目的で特定の相関ベクトルを使用するようにプラットフォームに指示できるようにします。 これは省略可能です。

構文

HRESULT CfSetCorrelationVector(
  [in] HANDLE                    FileHandle,
  [in] const PCORRELATION_VECTOR CorrelationVector
);

パラメーター

[in] FileHandle

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

[in] CorrelationVector

FileHandle に関連付ける特定の相関ベクトル。

戻り値

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

注釈

プラットフォームでは、最初に開かれたときに各ファイルに関連付けベクトルが自動的に割り当てられ、共通 のCF_CALLBACK_INFOの一部として、同期プロバイダーへのコールバックごとにこの関連付けベクトルが提供されます。 同期プロバイダーが要求を満たす (同期プロバイダーによって定義されている) 内部ステージを通じて進行するにつれて、同期エンジンがこの関数を呼び出して相関ベクトル "clock" の最後の桁をインクリメントすることをお勧めします。

要件

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

こちらもご覧ください

CF_CALLBACK_INFO