NDK_FN_COMPLETE_CONNECT_EX コールバック関数 (ndkpi.h)

[アーティクル]
03/05/2024

NdkCompleteConnectEx (NDK_FN_COMPLETE_CONNECT_EX) 関数は、非同期接続要求を完了します。

構文

NDK_FN_COMPLETE_CONNECT_EX NdkFnCompleteConnectEx;

NTSTATUS NdkFnCompleteConnectEx(
  [in]           NDK_CONNECTOR *pNdkConnector,
  [in, optional] NDK_FN_DISCONNECT_EVENT_CALLBACK_EX DisconnectEvent,
  [in, optional] PVOID DisconnectEventContext,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

パラメーター

[in] pNdkConnector

NDK コネクタオブジェクト (NDK_CONNECTOR) へのポインター。

[in, optional] DisconnectEvent

省略可能な切断通知コールバック関数 NdkDisconnectEventCallbackEx 関数 NDK_FN_DISCONNECT_EVENT_CALLBACK_EXのエントリポイント。プロバイダーは、ピアが切断されたときにこのコールバック関数を呼び出します。

[in, optional] DisconnectEventContext

DisconnectEvent パラメーターで指定された NdkDisconnectEventCallback 関数に戻すコンテキスト値。

[in] RequestCompletion

要求完了コールバック NdkRequestCompletion 関数 (NDK_FN_REQUEST_COMPLETION) へのポインター。

[in, optional] RequestContext

プロバイダーが NdkRequestCompletion 関数に戻すコンテキスト値。この値は RequestCompletion パラメーターで指定します。

戻り値

NDK_FN_COMPLETE_CONNECT関数は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	要求が正常に完了しました。
STATUS_PENDING	要求は保留中です。プロバイダーは、RequestCompletion パラメーターで指定された NdkRequestCompletion 関数を呼び出して、要求を非同期的に完了します。
STATUS_CONNECTION_INVALID	キューペアが接続していないため、要求は失敗しました。重要: この状態コードを使用すると、要求はインラインだけでなく非同期的にも失敗する可能性があります。
STATUS_CONNECTION_ABORTED	受け入れ側ピアは、保留中の接続確立を破棄しました。
STATUS_IO_TIMEOUT	接続の確立がタイムアウトしたため、要求は失敗しました。これは致命的または永続的な障害を示すものではありませんが、このコネクタの接続確立は終了します。重要: この状態コードを使用すると、要求はインラインだけでなく非同期的にも失敗する可能性があります。
その他の状態コード	エラーが発生しました。

解説

NdkCompleteConnectEx 関数は、NdkConnect (NDK_FN_CONNECT) 関数の以前の呼び出しによって開始された接続要求を完了します。 NDK コンシューマーは、ピアが接続要求を受け入れた後、 NdkCompleteConnectEx を呼び出します。

要件

要件	値
サポートされている最小のクライアント	NDKPI 2.1 以降でサポートされています。
サポートされている最小のサーバー	Windows Server 2022
対象プラットフォーム	Windows
ヘッダー	ndkpi.h (Ndkpi.h を含む)
IRQL	<=DISPATCH_LEVEL