RAS 서버 및 포트 관리 정보

RAS 서버 관리 함수는 지정된 RAS 서버 및 해당 포트에 대한 정보를 가져옵니다. 이러한 함수는 지정된 RAS 서버 포트에서 연결을 종료하는 데도 사용됩니다.

MprAdminServerGetInfo 함수는 RAS 서버의 구성에 대한 정보를 포함하는 MPR_SERVER_0 구조를 반환합니다. 반환된 정보에는 현재 연결에 사용할 수 있는 포트 수, 현재 사용 중인 포트 수 및 서버 버전 번호가 포함됩니다.

MprAdminPortEnum 함수는 RAS_PORT_0 구조체의 배열을 검색합니다. 각 구조체에는 RAS 서버에 구성된 포트 중 하나에 대한 정보가 포함됩니다. 각 포트에 대한 정보에는 다음이 포함됩니다.

• 포트의 이름
• 포트에 연결된 디바이스에 대한 정보
• 포트와 연결된 RAS 서버가 Windows NT/Windows 2000 서버인지 여부
• 포트가 현재 사용 중인지 여부 및 포트가 있는 경우 연결에 대한 정보

특정 연결에서 사용 중인 포트를 가져오려면 hConnection 매개 변수에서 MprAdminPortEnum 핸들을 해당 연결에 전달합니다. 연결에 대한 핸들을 가져오려면 MprAdminConnectionEnum 함수를 사용합니다. 또는 RAS 관리 DLL을 구현한 경우 MprAdminAcceptNewConnection 및 MprAdminAcceptNewConnection2 함수는 연결이 설정될 때 각 새 연결에 대한 핸들을 받습니다.

MprAdminPortGetInfo 함수를 호출하여 RAS 서버의 지정된 포트에 대한 추가 정보를 가져올 수 있습니다. 이 함수는 RAS_PORT_0 구조체와 포트의 현재 상태에 대한 추가 정보를 포함하는 RAS_PORT_1 구조를 반환합니다. RasAdminPortGetInfo 함수는 포트와 연결된 미디어별 키의 값을 설명하는 RAS_PARAMETERS 구조체 배열도 반환합니다. RAS_PARAMETERS 구조체는 RAS_PARAMS_FORMAT 열거형의 값을 사용하여 각 미디어별 키에 대한 값의 형식을 나타냅니다.

MprAdminPortGetInfo 함수는 포트에서 현재 연결(있는 경우)에 대한 다양한 통계 카운터를 포함하는 RAS_PORT_STATISTICS 구조체도 반환합니다. 다중 링크 연결의 일부인 포트의 경우 MprAdminPortGetInfo 는 개별 포트에 대한 통계와 연결에 관련된 모든 포트에 대한 누적 통계를 반환합니다. MprAdminPortClearStats 함수를 사용하여 포트에 대한 통계 카운터를 다시 설정할 수 있습니다. MprAdminPortDisconnect 함수는 사용 중인 포트의 연결을 끊습니다.

MprAdminBufferFree 함수를 사용하여 MprAdminPortEnum 및 MprAdminPortGetInfo 함수에서 할당한 메모리를 해제합니다. MprAdminGetErrorString 함수를 사용하여 RAS 서버 관리(RasAdmin) 함수 중 하나에서 반환된 RAS 오류 코드를 설명하는 문자열을 가져옵니다.