RasGetConnectStatusA 함수(ras.h)

  • 아티클

RasGetConnectStatus 함수는 지정된 원격 액세스 연결의 현재 상태 대한 정보를 검색합니다. 애플리케이션은 이 호출을 사용하여 비동기 RasDial 호출이 완료되는 시기를 결정할 수 있습니다.

구문

DWORD RasGetConnectStatusA(
  [in]      HRASCONN         unnamedParam1,
  [in, out] LPRASCONNSTATUSA unnamedParam2
);

매개 변수

[in] unnamedParam1

상태 검색할 원격 액세스 연결을 지정합니다. 이 핸들은 RasDial 또는 RasEnumConnections에서 가져와야 합니다.

[in, out] unnamedParam2

출력 시 상태 정보를 수신하는 RASCONNSTATUS 구조체에 대한 포인터입니다.

입력 시 전달되는 구조체의 버전을 식별하기 위해 구조체의 dwSize 멤버를 sizeof(RASCONNSTATUS)로 설정합니다.

반환 값

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

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

값 의미
ERROR_NOT_ENOUGH_MEMORY
 함수가 작업을 완료하는 데 충분한 메모리를 할당할 수 없습니다.

설명

RasGetConnectStatus의 반환 값이 RasGetConnectStatus에서 반환된 RASCONNSTATUS 구조체의 dwError 멤버 값과 반드시 같은 것은 아닙니다. RasGetConnectStatus의 반환 값은 RasGetConnectStatus 함수 호출 중에 발생하는 오류를 나타내는 반면 dwError 멤버는 연결이 설정되지 않은 오류를 나타냅니다.

참고

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

요구 사항

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

추가 정보

RASCONNSTATUS

Rasdial

RasEnumConnections

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

원격 액세스 서비스 함수