RASDIALFUNC 콜백 함수(ras.h)

아티클
03/01/2024

RasDialFunc 콜백 함수는 RAS 연결 프로세스 중에 상태 변경이 발생할 때 RasDial 함수에 의해 호출됩니다.

구문

RASDIALFUNC Rasdialfunc;

void Rasdialfunc(
  UINT unnamedParam1,
  tagRASCONNSTATE unnamedParam2,
  DWORD unnamedParam3
)
{...}

매개 변수

unnamedParam1

unnamedParam2

unnamedParam3

반환 값

없음

설명

RasDialFunc 콜백 함수를 호출하는 동안 RasDial 연결 작업이 일시 중단됩니다. 이러한 이유로 RasDialFunc 구현은 일반적으로 가능한 한 빨리 반환해야 합니다. 해당 규칙에는 두 가지 예외가 있습니다. 모뎀과 같은 비동기(느린) 디바이스에는 종종 시간 제한 기간이 밀리초가 아닌 초 단위로 측정됩니다. RasDialFunc 함수의 느린 반환은 일반적으로 문제가 되지 않습니다. dwError가 0이 아니면 오류가 발생했음을 나타내는 프롬프트 반환 요구 사항도 적용되지 않습니다. 예를 들어 오류 대화 상자를 설치하고 사용자 입력을 기다리는 것이 안전합니다.

RasDialFunc 구현은 플랫폼마다 다를 수 있으므로 특정 RASCONNSTATE 연결 상태의 순서 또는 발생에 따라 달라지지 않아야 합니다.

RasDialFunc 콜백 함수 내에서 RasDial 함수를 호출하지 마세요. 콜백 함수 내에서 RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString 및 RasHangUp 함수를 호출합니다. 예를 들어 콜백 함수 내에서 RasGetConnectStatus 를 호출하면 연결 디바이스의 이름과 유형을 확인하는 데 유용합니다.

참고 편의를 위해 RasDialFunc 콜백 함수 내에서 RasHangUp을 호출할 수 있습니다. 그러나 대부분의 중단 처리는 RasDialFunc 콜백 함수가 반환된 후에 발생합니다.

참고RasDialFunc 는 애플리케이션 정의 또는 라이브러리 정의 함수 이름의 자리 표시자입니다.

요구 사항

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