RasConnectionNotificationA 함수(ras.h)

  • 아티클

RasConnectionNotification 함수는 RAS 연결을 만들거나 종료할 때 시스템이 신호 상태로 설정하는 이벤트 개체를 지정합니다.

구문

DWORD RasConnectionNotificationA(
  [in] HRASCONN unnamedParam1,
  [in] HANDLE   unnamedParam2,
  [in] DWORD    unnamedParam3
);

매개 변수

[in] unnamedParam1

알림을 받는 RAS 연결에 대한 핸들입니다. RasDial 또는 RasEnumConnections 함수에서 반환되는 핸들일 수 있습니다. 이 매개 변수가 INVALID_HANDLE_VALUE 경우 로컬 클라이언트의 모든 RAS 연결에 대한 알림이 수신됩니다.

[in] unnamedParam2

이벤트 개체의 핸들을 지정합니다. CreateEvent 함수를 사용하여 이벤트 개체를 만듭니다.

[in] unnamedParam3

시스템이 hEvent 매개 변수로 지정된 이벤트 개체에 신호를 보낼 수 있도록 하는 RAS 이벤트를 지정합니다. 이 매개 변수는 다음 값의 조합입니다.

값 의미
RASCN_Connection
 hrasconn이 INVALID_HANDLE_VALUE 경우 RAS 연결이 만들어지면 hEvent가 신호를 보냅니다.
RASCN_Disconnection
 hEvent 는 hrasconn 연결이 종료될 때 신호를 수신합니다. hrasconn이 멀티링크 연결인 경우 모든 하위 엔티티의 연결이 끊어지면 이벤트가 신호를 보냅니다. hrasconn이 INVALID_HANDLE_VALUE 경우 RAS 연결이 종료될 때 이벤트가 신호를 보냅니다.
RASCN_BandwidthAdded
 Windows NT: hrasconn이 결합된 멀티링크 연결에 대한 핸들인 경우 하위 엔트리가 연결될 때 hEvent가 신호를 수신합니다.
RASCN_BandwidthRemoved
 Windows NT: hrasconn이 결합된 멀티링크 연결에 대한 핸들인 경우 하위 엔트리의 연결이 끊어지면 hEvent가 신호를 보냅니다.

반환 값

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

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

설명

이벤트 개체가 신호를 받은 시기를 확인하려면 대기 함수를 사용합니다.

이벤트가 신호를 받으면 RasEnumConnections와 같은 다른 RAS 함수를 사용하여 생성되거나 종료된 RAS 연결에 대한 자세한 정보를 가져옵니다.

참고

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

요구 사항

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

추가 정보

CreateEvent

RasEnumConnections

RAS(원격 액세스 서비스) 개요

원격 액세스 서비스 함수