RAS_PORT_0 구조체

[이 버전의 RAS_PORT_0 구조는 Windows Vista에서 지원되지 않습니다. 대신 mprapi.h에 정의된 최신 RAS_PORT_0 사용합니다.]

RAS_PORT_0 구조에는 RAS 포트를 설명하는 정보가 포함되어 있습니다.

구문

typedef struct _RAS_PORT_0 {
  WCHAR wszPortName[RASSAPI_MAX_PORT_NAME];
  WCHAR wszDeviceType[RASSAPI_MAX_DEVICETYPE_NAME];
  WCHAR wszDeviceName[RASSAPI_MAX_DEVICE_NAME];
  WCHAR wszMediaName[RASSAPI_MAX_MEDIA_NAME];
  DWORD reserved;
  DWORD Flags;
  WCHAR wszUserName[UNLEN + 1];
  WCHAR wszComputer[NETBIOS_NAME_LEN];
  DWORD dwStartSessionTime;
  WCHAR wszLogonDomain[DNLEN + 1];
  BOOL  fAdvancedServer;
} RAS_PORT_0, *PRAS_PORT_0;

멤버

wszPortName

포트 이름(예: "COM1")을 지정하는 null로 끝나는 유니코드 문자열입니다.

wszDeviceType

모뎀 또는 ISDN과 같이 연결이 이루어진 디바이스의 유형을 지정하는 null로 끝나는 유니코드 문자열입니다. 이 멤버에 지정할 수 있는 디바이스 유형 목록에는 타사 디바이스를 포함하여 서버에 설치된 모든 디바이스 유형이 포함됩니다.

wszDeviceName

"Hayes 9600" 또는 "PCIMACISDN1"과 같이 연결이 만들어진 디바이스의 이름을 지정하는 null로 끝나는 유니코드 문자열입니다.

wszMediaName

연결에 사용되는 미디어의 이름(예: rasser 또는 rastapi)을 지정하는 null로 끝나는 유니코드 문자열을 지정합니다.

reserved

예약되어 있습니다.

플래그

이 포트에서 만든 연결의 특성을 지정하는 비트 플래그 집합을 지정합니다. 이 멤버는 다음 플래그의 조합일 수 있습니다.

값	의미
GATEWAY_ACTIVE	이 플래그를 설정하면 NetBIOS 게이트웨이가 서버에서 활성화됩니다.
MESSENGER_PRESENT	이 플래그가 설정되면 메신저 서비스가 원격 클라이언트에서 실행되고 있습니다.
PORT_MULTILINKED	이 플래그를 설정하면 포트가 다른 포트와 다중 연결됩니다. 이 정보를 사용하여 연결 상태 다중 링크 포트로 표시합니다. 다중 연결 포트의 경우 RAS_PORT_STATISTICS 구조에는 두 가지 통계 집합이 포함됩니다. 하나는 포트에만 해당되고 다른 하나는 다중 링크 연결의 결합된 포트에 대한 것입니다.
PPP_CLIENT	이 플래그가 설정되면 PPP를 사용하여 연결된 원격 클라이언트입니다. 이 플래그를 설정하지 않으면 AMB 프로토콜을 사용하여 연결된 원격 클라이언트입니다.
REMOTE_LISTEN	이 플래그를 설정하면 NetBIOS 게이트웨이의 RemoteListen 매개 변수가 서버에서 1로 설정됩니다.
USER_AUTHENTICATED	이 플래그를 설정하면 원격 클라이언트가 서버에 연결되고 사용자가 인증됩니다. 이 플래그를 확인하여 클라이언트가 실제로 포트에 연결되어 있는지 확인합니다.

MESSENGER_PRESENT, GATEWAY_ACTIVE 및 REMOTE_LISTEN 플래그가 설정된 경우 messenger 서비스를 사용하여 원격 클라이언트에 관리 메시지를 보냅니다. MESSENGER_PRESENT 및 REMOTE_LISTEN 설정되었지만 GATEWAY_ACTIVE 설정되지 않은 경우 클라이언트가 연결된 RAS 서버에서만 클라이언트로 메시지를 보냅니다.

wszUserName

이 포트에 연결된 원격 사용자의 이름을 지정하는 null로 끝나는 유니코드 문자열입니다.

wszComputer

원격 클라이언트 컴퓨터의 이름을 지정하는 null로 끝나는 유니코드 문자열입니다.

dwStartSessionTime

클라이언트가 이 포트의 RAS 서버에 연결된 시간을 1970년 1월 1일부터 초 단위로 지정합니다. 표준 시간 함수를 사용하여 표시할 이 값의 서식을 지정합니다.

wszLogonDomain

원격 사용자가 인증된 도메인의 이름을 지정하는 null로 끝나는 유니코드 문자열을 지정합니다. 이 문자열은 "\\" 접두사 없이 도메인 이름에만 해당합니다.

fAdvancedServer

이 포트와 연결된 RAS 서버가 Windows 2000 고급 서버와 같은 고급 서버인 경우 0이 아닌 플래그를 지정합니다. 이 정보를 사용하여 사용자 계정 데이터베이스가 있는 서버의 이름을 확인합니다. RAS 서버가 고급 서버인 경우 접두사 "\\"를 wszLogonDomain 멤버에 반환된 이름에 연결하여 사용자 계정 서버의 이름을 가져옵니다. 고급 서버의 경우 로컬 로그온 도메인 이름이 서버 이름과 동일하기 때문입니다. RAS 서버가 워크스테이션인 경우 RasAdminGetUserAccountServer 함수를 사용하여 사용자 계정 서버의 이름을 가져옵니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
클라이언트 지원 종료	Windows XP
서버 지원 종료	Windows Server 2003
헤더	Rassapi.h

추가 정보

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

RAS 서버 관리 구조

RAS_PORT_1

RAS_PORT_STATISTICS

RasAdminGetUserAccountServer

RasAdminPortEnum