RAS_CONNECTION_EX 구조체(mprapi.h)
RAS_CONNECTION_EX 구조에는 연결과 연결된 사용자 이름, 도메인 및 GUID(Globally Unique Identifier), NAP(네트워크 액세스 보호) 격리 상태, 패킷 통계, PPP(Point-to-Point) 및 IKEv2(Internet Key Exchange 버전 2) 관련 정보가 포함된 연결에 대한 특정 정보가 포함됩니다.
RAS_CONNECTION_EX 구조체에는 RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2및RAS_CONNECTION_3 결합된 구조체와 동일한 정보가 대부분 포함됩니다.
구문
typedef struct _RAS_CONNECTION_EX {
MPRAPI_OBJECT_HEADER Header;
DWORD dwConnectDuration;
ROUTER_INTERFACE_TYPE dwInterfaceType;
DWORD dwConnectionFlags;
WCHAR wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1];
WCHAR wszUserName[UNLEN + 1];
WCHAR wszLogonDomain[DNLEN + 1];
WCHAR wszRemoteComputer[NETBIOS_NAME_LEN + 1];
GUID guid;
RAS_QUARANTINE_STATE rasQuarState;
FILETIME probationTime;
DWORD dwBytesXmited;
DWORD dwBytesRcved;
DWORD dwFramesXmited;
DWORD dwFramesRcved;
DWORD dwCrcErr;
DWORD dwTimeoutErr;
DWORD dwAlignmentErr;
DWORD dwHardwareOverrunErr;
DWORD dwFramingErr;
DWORD dwBufferOverrunErr;
DWORD dwCompressionRatioIn;
DWORD dwCompressionRatioOut;
DWORD dwNumSwitchOvers;
WCHAR wszRemoteEndpointAddress[MAXIPADRESSLEN + 1];
WCHAR wszLocalEndpointAddress[MAXIPADRESSLEN + 1];
PROJECTION_INFO ProjectionInfo;
HANDLE hConnection;
HANDLE hInterface;
} RAS_CONNECTION_EX, *PRAS_CONNECTION_EX;
멤버
Header
RAS_CONNECTION_EX 구조체의 버전을 지정하는 MPRAPI_OBJECT_HEADER 구조체입니다.
dwConnectDuration
연결 기간(초)을 나타내는 값입니다.
dwInterfaceType
연결 인터페이스의 형식을 식별하는 ROUTER_INTERFACE_TYPE 열거형입니다.
dwConnectionFlags
연결 특성을 지정하는 플래그의 비트맵입니다. dwConnectionFlags에는 다음 값 중 하나 이상이 포함되어야 합니다.
| 값 | 의미 |
|---|---|
|
연결에서 PPP(지점 간 프로토콜)를 사용하고 있습니다. |
|
메신저 서비스는 클라이언트에서 활성 상태이며 MprAdminSendUserMessage를 사용하여 클라이언트로 메시지를 보낼 수 있습니다. |
|
연결은 현재 격리되어 있습니다. 격리에서 연결을 제거하는 방법에 대한 자세한 내용은 MprAdminConnectionRemoveQuarantine을 참조하세요. |
|
연결에서 ARAP(AppleTalk Remote Access Protocol)를 사용하고 있습니다. |
|
연결에서 IKEv2를 사용하고 있습니다. |
|
연결에서 IKEv2를 사용하고 있으며 서버에 연결할 수 없습니다. |
wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]
이 연결에 대한 인터페이스의 이름을 포함하는 null로 끝나는 유니코드 문자열입니다.
wszUserName[UNLEN + 1]
연결에 로그온한 사용자의 이름을 포함하는 null로 끝나는 유니코드 문자열입니다.
wszLogonDomain[DNLEN + 1]
연결된 사용자가 인증되는 도메인을 포함하는 null로 끝나는 유니코드 문자열입니다.
wszRemoteComputer[NETBIOS_NAME_LEN + 1]
원격 컴퓨터의 이름을 포함하는 null로 끝나는 유니코드 문자열입니다.
guid
연결을 식별하는 GUID입니다. 들어오는 연결의 경우 이 GUID는 연결이 활성 상태인 경우에만 유효합니다.
rasQuarState
연결의 NAP 격리 상태를 지정하는 RAS_QUARANTINE_STATE 구조체입니다.
probationTime
연결이 격리된 후 연결이 삭제되는 데 필요한 시간을 지정하는 FILETIME 구조체입니다. 이 값은 rasQuarState 값이 RAS_QUAR_STATE_PROBATION 경우에만 유효합니다.
dwBytesXmited
연결에서 전송되는 바이트 수를 지정하는 값입니다.
dwBytesRcved
연결에서 받은 바이트 수를 지정하는 값입니다.
dwFramesXmited
연결에서 전송되는 프레임 수를 지정하는 값입니다.
dwFramesRcved
연결에서 수신된 프레임 수를 지정하는 값입니다.
dwCrcErr
연결에서 CRC(순환 중복 검사) 오류 수를 지정하는 값입니다.
dwTimeoutErr
연결에 대한 시간 제한 오류 수를 지정하는 값입니다.
dwAlignmentErr
연결의 맞춤 오류 수를 지정하는 값입니다.
dwHardwareOverrunErr
연결에서 하드웨어 오버런 오류 수를 지정하는 값입니다.
dwFramingErr
연결의 프레이밍 오류 수를 지정하는 값입니다.
dwBufferOverrunErr
연결에 대한 버퍼 오버런 오류 수를 지정하는 값입니다.
dwCompressionRatioIn
이 연결에서 받은 데이터가 압축되는 백분율을 지정하는 값입니다. dwCompressionRatioIn 은 압축되지 않은 상태에서 동일한 데이터의 크기로 나눈 압축된 데이터의 크기입니다.
dwCompressionRatioOut
이 연결에서 전송되는 데이터가 압축되는 백분율을 지정하는 값입니다. 비율은 압축된 데이터의 크기를 압축되지 않은 상태에서 동일한 데이터의 크기로 나눈 크기입니다.
dwNumSwitchOvers
RFC4555 정의된 대로 연결에서 발생한 MOBIKE(IKEv2 Mobility and Multihoming Protocol) 스위치의 수를 지정하는 값입니다. dwNumSwitchOvers 는 dwConnectionFlags 가 RAS_FLAGS_IKEV2_CONNECTION 경우에만 유효합니다.
wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]
연결에 있는 원격 컴퓨터의 IP 주소를 포함하는 null로 끝나는 유니코드 문자열입니다. 이 문자열은 "a.b.c.d" 형식입니다.
wszLocalEndpointAddress[MAXIPADRESSLEN + 1]
연결에 있는 로컬 컴퓨터의 IP 주소를 포함하는 null로 끝나는 유니코드 문자열입니다. 이 문자열은 "a.b.c.d" 형식입니다.
ProjectionInfo
PPP_PROJECTION_INFO 또는 IKEV2_PROJECTION_INFO 구조체를 포함하는 PROJECTION_INFO 구조체입니다.
hConnection
RAS 연결에 대한 핸들입니다.
hInterface
RAS 연결 인터페이스에 대한 핸들입니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 머리글 | mprapi.h |