RasGetProjectionInfoEx 함수(ras.h)

  • 아티클

RasGetProjectionInfoEx 함수는 로컬 클라이언트의 모든 RAS 연결에 대한 PPP(지점 간 프로토콜) 또는 IKEv2(인터넷 키 교환 버전 2) 원격 액세스 프로젝션 작업에 대한 정보를 가져옵니다.

구문

DWORD RasGetProjectionInfoEx(
  [in]      HRASCONN             hrasconn,
  [in, out] PRAS_PROJECTION_INFO pRasProjection,
  [in, out] LPDWORD              lpdwSize
);

매개 변수

[in] hrasconn

터널 엔드포인트를 변경할 RAS 연결에 대한 핸들입니다. RasDial 또는 RasEnumConnections 함수에서 반환되는 핸들일 수 있습니다.

[in, out] pRasProjection

RAS 연결에 대한 프로젝션 정보를 수신하는 RAS_PROJECTION_INFO 구조체에 대한 포인터입니다.

[in, out] lpdwSize

pRasProjection이 가리키는 버퍼의 크기(바이트)를 지정하는 포인터(입력)입니다. 출력에서 이 변수는 pRasProjection이 가리키는 RAS_PROJECTION_INFO 구조체의 수를 저장하는 데 필요한 버퍼의 크기(바이트)를 받습니다.

반환 값

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

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

값 의미
ERROR_BUFFER_TOO_SMALL
 pRasProjection이 가리키는 버퍼가 요청된 정보를 포함할 만큼 크지 않습니다.
ERROR_INVALID_HANDLE
 hrasconn 매개 변수가 유효한 핸들이 아닙니다.
ERROR_INVALID_PARAMETER
 함수가 잘못된 매개 변수를 사용하여 호출되었습니다.
ERROR_INVALID_SIZE
 pRasProjection이 가리키는 구조체의 dwSize 멤버는 잘못된 크기를 지정합니다.
ERROR_PROTOCOL_NOT_CONFIGURED
 연결의 전화 번호부 항목에 프로토콜 협상을 시도할 필요가 없으므로 정보가 요청된 제어 프로토콜이 성공하거나 실패하지 않았습니다.

설명

원격 액세스 프로젝션은 원격 액세스 서버와 원격 클라이언트가 네트워크 프로토콜 관련 정보를 협상하는 프로세스입니다. 원격 액세스 서버는 이 네트워크 프로토콜 관련 정보를 사용하여 네트워크의 원격 클라이언트를 나타냅니다.

원격 액세스 프로젝션 정보는 운영 체제가 원격 액세스 연결에서 RASCS_Projected 상태를 실행할 때까지 사용할 수 없습니다. RasGetProjectionInfoEx가 RASCS_Projected 상태 이전에 호출되면 ERROR_PROJECTION_NOT_COMPLETE 반환합니다.

요구 사항

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

추가 정보

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

원격 액세스 서비스 함수