RasGetSubEntryHandleA 함수(ras.h)

아티클
11/20/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