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

[アーティクル]
08/07/2023

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

構文

NDK_FN_COMPLETE_CONNECT NdkFnCompleteConnect;

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

パラメーター

[in] pNdkConnector

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

[in, optional] DisconnectEvent

ピアの切断時にプロバイダーが呼び出す、省略可能な切断通知コールバック NdkDisconnectEventCallback 関数 (NDK_FN_DISCONNECT_EVENT_CALLBACK)。

[in, optional] DisconnectEventContext

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

[in] RequestCompletion

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

[in, optional] RequestContext

プロバイダーが RequestCompletion パラメーターで指定された NdkRequestCompletion 関数に戻すコンテキスト値。

戻り値

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

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

解説

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

要件

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