MprAdminInterfaceConnect 함수(mprapi.h)

아티클
03/15/2023

MprAdminInterfaceConnect 함수는 지정된 WAN 인터페이스에 대한 연결을 만듭니다.

구문

DWORD MprAdminInterfaceConnect(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] HANDLE            hEvent,
  [in] BOOL              fSynchronous
);

매개 변수

[in] hMprServer

이 호출을 실행할 라우터에 대한 핸들입니다. MprAdminServerConnect를 호출하여 이 핸들을 가져옵니다.

[in] hInterface

인터페이스에 대한 핸들입니다. 이 핸들은 MprAdminInterfaceCreate에 대한 이전 호출에서 가져옵니다.

[in] hEvent

인터페이스 연결 시도가 완료된 후 신호를 받은 이벤트에 대한 핸들입니다. 함수는 연결 시도를 시작하고 즉시 반환합니다. 이벤트가 신호를 받은 후 MprAdminInterfaceGetInfo를 호출하여 연결 시도의 결과를 얻을 수 있습니다.

이 매개 변수가 NULL이고 fBlocking 이 TRUE이면 이 호출은 동기적입니다. 즉, 연결 시도가 완료될 때까지 함수가 반환되지 않습니다.

hMprServer가 원격 라우터를 지정하는 경우 호출 애플리케이션은 이 매개 변수에 대해 NULL을 지정해야 합니다.

[in] fSynchronous

hEvent가 NULL이고 이 매개 변수가 TRUE로 설정된 경우 연결 시도가 완료될 때까지 함수가 반환되지 않습니다.

hEvent가 NULL이고 이 매개 변수가 FALSE로 설정된 경우 함수는 즉시 반환됩니다. PENDING의 반환 값은 연결 시도가 성공적으로 시작되었음을 나타냅니다.

hEvent가 NULL이 아닌 경우 이 매개 변수는 무시됩니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

값	의미
ERROR_ACCESS_DENIED	호출 애플리케이션에 충분한 권한이 없습니다.
ERROR_ALREADY_CONNECTING	이 인터페이스에서 연결이 이미 진행 중입니다.
ERROR_DDM_NOT_RUNNING	DDM(Demand Dial Manager)이 실행되고 있지 않습니다.
ERROR_INTERFACE_DISABLED	인터페이스는 현재 사용하지 않도록 설정되어 있습니다.
ERROR_INTERFACE_HAS_NO_DEVICES	이 인터페이스에 사용할 수 있는 어댑터가 없습니다.
ERROR_INVALID_HANDLE	hInterface 값이 잘못되었습니다.
ERROR_SERVICE_IS_PAUSED	현재 Demand Dial 서비스가 일시 중지되었습니다.
보류 중인	인터페이스가 연결 중입니다. 호출 애플리케이션이 지정된 경우 hEvent 핸들에서 대기해야 합니다. 이벤트가 신호를 받은 후 MprAdminInterfaceGetInfo를 호출하여 연결 상태 및 관련 오류를 가져올 수 있습니다.

설명

다음 표에서는 hEvent 와 fBlocking 간의 관계를 요약합니다.

hEvent	fBlocking	결과
이벤트 핸들	무시됨	호출이 즉시 반환됩니다. PENDING의 반환 값은 시도가 성공적으로 시작되었음을 나타냅니다. hEvent에서 기다립니다. hEvent가 신호를 받으면 MprAdminInterfaceGetInfo를 사용하여 연결 시도의 성공 또는 실패를 확인합니다.
NULL	TRUE	연결 시도가 완료될 때까지 호출이 반환되지 않습니다.
NULL	FALSE	호출이 즉시 반환됩니다. PENDING의 반환 값은 시도가 성공적으로 시작되었음을 나타냅니다.

요구 사항


지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	mprapi.h
라이브러리	Mprapi.lib
DLL	Mprapi.dll