RasGetSubEntryHandleA 함수(ras.h)

아티클
03/05/2024

RasGetSubEntryHandle 함수는 멀티링크 연결의 지정된 하위 엔트리에 대한 연결 핸들을 검색합니다.

구문

DWORD RasGetSubEntryHandleA(
  [in]  HRASCONN   unnamedParam1,
  [in]  DWORD      unnamedParam2,
  [out] LPHRASCONN unnamedParam3
);

매개 변수

[in] unnamedParam1

다중 링크 전화 번호부 항목에 대해 RasDial 함수에서 반환하는 HRASCONN 연결 핸들을 지정합니다.

[in] unnamedParam2

전화 번호부 항목에 유효한 하위 엔트리 인덱스를 지정합니다.

[out] unnamedParam3

하위 엔트리 연결을 나타내는 연결 핸들을 수신하는 HRASCONN 변수에 대한 포인터입니다.

반환 값

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

함수가 실패하면 반환 값은 다음 오류 코드 중 하나이거나 라우팅 및 원격 액세스 오류 코드 또는 Winerror.h의 값입니다.

값	의미
ERROR_INVALID_HANDLE	hRasConn 연결 핸들은 연결된 전화 번호부 항목을 나타내지 않습니다.
ERROR_PORT_NOT_OPEN	hRasConn 및 dwSubEntry 매개 변수는 유효하지만 지정된 하위 엔트리가 연결되지 않았습니다.
ERROR_NO_MORE_ITEMS	dwSubEntry로 지정된 값이 전화 번호부 항목의 최대 하위 엔티티 수를 초과합니다.

설명

hRasConn 매개 변수에 지정된 연결 핸들은 전체 멀티링크 연결을 참조하지만 *lphRasConn 매개 변수에 반환된 연결 핸들은 하위 연결만 참조합니다. RasHangUp, RasGetConnectStatus 및 RasGetProjectionInfoEx 함수를 포함하여 hRasConn 매개 변수를 수락하는 모든 함수에서 하위 엔트리 연결 핸들을 사용합니다. 다중 링크 항목에 대해 RasGetProjectionInfo에서 반환하는 프로젝션 정보는 기본 연결 핸들과 동일한 각 하위 엔트리 연결 핸들에 대해 동일합니다.

RasGetSubEntryHandle에서 반환된 핸들에서 RasHangUp을 호출하여 다중 링크 연결에서 단일 링크를 종료할 수 있습니다. 그러나 RasGetConnectStatus 를 사용하여 링크가 종료되었는지 확인할 수는 없습니다. RasGetConnectStatus 는 링크가 성공적으로 종료되더라도 ERROR_INVALID_HANDLE 반환하지 않을 수 있습니다.

참고

ras.h 헤더는 RAsGetSubEntryHandle을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ras.h
라이브러리	Rasapi32.lib
DLL	Rasapi32.dll