NDK_FN_COMPLETE_CONNECT_EX 콜백 함수(ndkpi.h)

아티클
02/29/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