RasAdminPortGetInfo 함수

[이 함수는 Windows NT Server 4.0과의 이전 버전과의 호환성을 위해서만 제공됩니다. Windows Server 2003에서 ERROR_CALL_NOT_IMPLEMENTED 반환합니다. 애플리케이션은 MprAdminPortGetInfo 함수를 사용해야 합니다.]

RasAdminPortGetInfo 함수는 지정된 서버에서 지정된 포트에 대한 정보를 검색합니다.

구문

DWORD RasAdminPortGetInfo(
  _In_  const WCHAR               *lpszServer,
  _In_  const WCHAR               *lpszPort,
  _Out_       RAS_PORT_1          *pRasPort1,
  _Out_       RAS_PORT_STATISTICS *pRasStats,
  _Out_       RAS_PARAMETERS      **ppRasParams
);

매개 변수

lpszServer [in]

RAS 서버의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 앞에 "\\" 문자가 있는 이름을 \\servername 형식으로 지정합니다.

lpszPort [in]

서버의 포트 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

pRasPort1 [out]

함수가 포트 상태에 대한 정보로 채우는 RAS_PORT_1 구조체에 대한 포인터입니다.

pRasStats [out]

함수가 포트에 대한 통계로 채우는 RAS_PORT_STATISTICS 구조체에 대한 포인터입니다.

ppRasParams [out]

RAS_PARAMETERS 구조체 배열의 주소를 수신하는 포인터 변수에 대한 포인터입니다. 각 구조체에는 MAXCONNECTBPS와 같은 미디어별 키의 이름과 관련 값이 포함됩니다. 애플리케이션이 이 메모리로 완료되면 RasAdminFreeBuffer 함수를 호출하여 해제합니다.

반환 값

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

함수가 실패하면 반환 값은 다음 오류 코드 중 하나일 수 있습니다.

값	의미
ERROR_DEV_NOT_EXIST	지정한 포트가 잘못되었습니다.
ERROR_NOT_ENOUGH_MEMORY	메모리가 부족하여 ppRasParams 배열에 대한 버퍼를 할당할 수 없습니다.

이 함수에 대한 확장 오류 정보는 없습니다. GetLastError를 호출하지 마세요.

요구 사항

요구 사항	값
클라이언트 지원 종료	Windows 2000 Professional
서버 지원 종료	Windows 2000 Server
헤더	Rassapi.h
라이브러리	Rassapi.lib
DLL	Rassapi.dll

추가 정보

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

RAS 서버 관리 함수

RAS_PARAMETERS

RAS_PORT_1

RAS_PORT_STATISTICS

RasAdminFreeBuffer