RasCustomDialFn 콜백 함수(ras.h)

아티클
08/25/2023

[이 함수는 Windows Server 2008을 기준으로 사용할 수 없습니다.

]

RasCustomDial 함수는 타사 사용자 지정 전화 걸기 DLL에서 내보내는 애플리케이션 정의 함수입니다. 이 기능을 사용하면 타사 공급업체가 사용자 지정 원격 액세스 전화 걸기 루틴을 구현할 수 있습니다.

구문

RasCustomDialFn Rascustomdialfn;

DWORD Rascustomdialfn(
  HINSTANCE hInstDll,
  LPRASDIALEXTENSIONS lpRasDialExtensions,
  LPCWSTR lpszPhonebook,
  LPRASDIALPARAMS lpRasDialParams,
  DWORD dwNotifierType,
  LPVOID lpvNotifier,
  LPHRASCONN lphRasConn,
  DWORD dwFlags
)
{...}

매개 변수

hInstDll

로드된 사용자 지정 다이얼 DLL의 instance 대한 핸들입니다.

lpRasDialExtensions

사용하도록 설정할 RasDial 확장 기능 집합을 지정하는 RASDIALEXTENSIONS 구조체에 대한 포인터입니다. 확장을 사용하도록 설정할 필요가 없는 경우 이 매개 변수를 NULL 로 설정합니다.

lpszPhonebook

전화 번호부(PBK) 파일의 전체 경로 및 파일 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL인 경우 함수는 현재 기본 전화 번호부 파일을 사용합니다. 기본 전화 번호부 파일은 전화 접속 네트워킹 대화 상자의 사용자 기본 설정 속성 시트에서 사용자가 선택한 파일입니다.

lpRasDialParams

RAS 연결에 대한 호출 매개 변수를 지정하는 RASDIALPARAMS 구조체에 대한 포인터입니다.

호출자는 전달되는 구조체의 버전을 식별하기 위해 RASDIALPARAMS 구조체의 dwSize 멤버를 sizeof(RASDIALPARAMS)로 설정해야 합니다.

dwNotifierType

이 매개 변수는 RasDial 함수의 dwNotifierType 매개 변수와 동일합니다. 자세한 내용은 RasDial 참조 페이지를 참조하세요.

lpvNotifier

이 매개 변수는 RasDial 함수의 lpvNotifier 매개 변수와 동일합니다. 자세한 내용은 RasDial 참조 페이지를 참조하세요.

lphRasConn

HRASCONN 형식의 변수에 대한 포인터입니다. RasDial을 호출하기 전에 HRASCONN 변수를 NULL로 설정합니다. RasDial이 성공하면 RAS 연결에 대한 핸들을 *lphRasConn에 저장합니다.

dwFlags

이 매개 변수는 나중에 사용할 수 있습니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESSlphRasConn 매개 변수가 가리키는 변수의 RAS 연결에 대한 핸들이 반환됩니다.

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

값	의미
ERROR_NOT_ENOUGH_MEMORY	함수가 작업을 완료하는 데 충분한 메모리를 할당할 수 없습니다.

설명

RAS는 RasDial에서 이 진입점을 호출합니다. 전화를 거는 항목에 대한 RASENTRY 구조의 szCustomDialDll 멤버가 사용자 지정 전화 걸기 DLL을 지정하는 경우

이 진입점이 RasDial을 호출하는 경우 lpRasDialExtensions 매개 변수는 NULL이 아니어야 하며 RASDIALEXTENSIONS 구조체의 dwFlags 멤버에는 RDEOPT_CustomDial 플래그가 설정되어 있어야 합니다.

사용자 지정 다이얼 DLL이 이 진입점을 지원하지 않는 경우 RAS는 rasDial 호출자에게 ERROR_CANNOT_DO_CUSTOMDIAL 반환합니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ras.h