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의 값입니다.
| 값 | 의미 |
|---|---|
|
pRasProjection이 가리키는 버퍼가 요청된 정보를 포함할 만큼 크지 않습니다. |
|
hrasconn 매개 변수가 유효한 핸들이 아닙니다. |
|
함수가 잘못된 매개 변수를 사용하여 호출되었습니다. |
|
pRasProjection이 가리키는 구조체의 dwSize 멤버는 잘못된 크기를 지정합니다. |
|
연결의 전화 번호부 항목에 프로토콜 협상을 시도할 필요가 없으므로 정보가 요청된 제어 프로토콜이 성공하거나 실패하지 않았습니다. |
설명
원격 액세스 프로젝션은 원격 액세스 서버와 원격 클라이언트가 네트워크 프로토콜 관련 정보를 협상하는 프로세스입니다. 원격 액세스 서버는 이 네트워크 프로토콜 관련 정보를 사용하여 네트워크의 원격 클라이언트를 나타냅니다.
원격 액세스 프로젝션 정보는 운영 체제가 원격 액세스 연결에서 RASCS_Projected 상태를 실행할 때까지 사용할 수 없습니다. RasGetProjectionInfoEx가 RASCS_Projected 상태 이전에 호출되면 ERROR_PROJECTION_NOT_COMPLETE 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ras.h |
| 라이브러리 | Rasapi32.lib |
| DLL | Rasapi32.dll |