CfExecute 関数 (cfapi.h)
すべての接続キーベースのプレースホルダー操作のメインエントリ ポイント。 これは、プラットフォームからのさまざまなコールバックに応答するために同期プロバイダーによって使用されることを目的としています。
構文
HRESULT CfExecute(
[in] const CF_OPERATION_INFO *OpInfo,
[in, out] CF_OPERATION_PARAMETERS *OpParams
);
パラメーター
[in] OpInfo
プレースホルダーに対する操作に関する情報。
[in, out] OpParams
プレースホルダーに対する操作のパラメーター。
戻り値
この関数が成功すると、 が返されます S_OK。 そうでない場合は、HRESULT エラー コードを返します。
注釈
CfExecute を有効に呼び出すと、同じ同期プロバイダー プロセスに属するすべての保留中のコールバック要求のタイマーがリセットされます。
CfExecute は、2 つの可変サイズの引数 ( CF_OPERATION_INFO と CF_OPERATION_PARAMETERS) を受け取り、1 つは操作の種類を識別し、もう 1 つは詳細な操作パラメーターを提供します。 どちらの引数も、対応する構造体の先頭にある StructSize フィールドで始まります。 CfExecute の呼び出し元は、構造サイズの正確なアカウンティングを担当します。
プラットフォームは、CfConnectSyncRoot に登録されているすべてのコールバック関数に ConnectionKey、TransferKey、CorrelationVector を提供します。 さらに、同期プロバイダーは、CfGetTransferKey を使用して TransferKey を取得し、CfGetCorrelationVector を使用して CorrelationVector を取得できます。
必要に応じて、同期プロバイダーは同期状態 BLOB をプラットフォームに提供できます。 CF_OPERATION_INFOの SyncStatus フィールドに null 以外のポインターが設定されている場合、その内容はファイルの最後のハンドルが削除されるまでファイルに保持されます。 プラットフォームは、クラウド ファイル プレースホルダーに対して失敗した操作に対して、この情報に対してクエリを実行します。 使用可能な場合、プラットフォームは提供された情報を使用して、ユーザーに対してより意味のある実用的なメッセージを作成します。
CF_OPERATION_INFOの SyncStatus フィールドに null ポインターが設定されている場合、プラットフォームは以前に設定した同期状態 (存在する場合) をクリアします。
すべての操作は、同期プロバイダー プロセスの任意のスレッド コンテキストで実行できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10、バージョン 1709 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | cfapi.h |
| Library | CldApi.lib |
| [DLL] | CldApi.dll |