RasGetSubEntryHandleA 함수(ras.h)
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의 값입니다.
값 | 의미 |
---|---|
|
hRasConn 연결 핸들은 연결된 전화 번호부 항목을 나타내지 않습니다. |
|
hRasConn 및 dwSubEntry 매개 변수는 유효하지만 지정된 하위 엔트리가 연결되지 않았습니다. |
|
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 |