RasHangUpA 함수(ras.h)

아티클
03/05/2024

RasHangUp 함수는 원격 액세스 연결을 종료합니다. 연결은 RAS 연결 핸들로 지정됩니다. 함수는 핸들과 연결된 모든 RASAPI32.DLL 리소스를 해제합니다.

구문

DWORD RasHangUpA(
  [in] HRASCONN unnamedParam1
);

매개 변수

[in] unnamedParam1

종료할 원격 액세스 연결을 지정합니다. RasDial 또는 RasEnumConnections에 대한 이전 호출에서 반환된 핸들입니다.

반환 값

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

함수가 실패하면 반환 값은 다음 오류 코드 중 하나이거나 라우팅 및 원격 액세스 오류 코드 또는 Winerror.h의 값입니다.

값	의미
ERROR_INVALID_HANDLE	hrasconn에 지정된 핸들이 잘못되었습니다.

설명

RasDial 호출이 아직 완료되지 않은 경우에도 연결이 종료됩니다.

이 호출 후에는 hrasconn 핸들을 더 이상 사용할 수 없습니다.

애플리케이션은 RasHangUp을 호출한 다음 즉시 종료하면 안 됩니다. 연결 상태 컴퓨터가 제대로 종료되려면 시간이 필요합니다. 시스템이 상태 머신을 조기에 종료하는 경우 상태 컴퓨터가 포트를 제대로 닫지 못하여 포트가 일관되지 않은 상태로 남을 수 있습니다. 또한 동일한 연결을 즉시 사용하려고 시도하면 연결을 사용할 수 없게 될 수 있습니다. 이러한 문제를 방지하는 간단한 방법은 RasHangUp에서 돌아온 후 Sleep(3000)을 호출하는 것입니다. 일시 중지 후 애플리케이션이 종료할 수 있습니다. 이러한 문제를 방지하기 위한 보다 응답성이 뛰어난 방법은 RasHangUp에서 돌아온 후 RasGetConnectStatus가 ERROR_INVALID_HANDLE 반환할 때까지 루프에서 RasGetConnectStatus(hrasconn) 및 Sleep(0) 을 호출하는 것입니다.

RasGetSubEntryHandle에서 반환된 핸들에서 RasHangUp을 호출하여 다중 링크 연결에서 단일 링크를 종료할 수 있습니다. 그러나 이 경우 RasGetConnectStatus 를 사용하여 링크가 종료되었는지 확인할 수 없습니다. RasGetConnectStatus 는 링크가 성공적으로 종료되더라도 ERROR_INVALID_HANDLE 반환하지 않을 수 있습니다.

참고

ras.h 헤더는 RAsHangUp을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ras.h
라이브러리	Rasapi32.lib
DLL	Rasapi32.dll