RasCustomDialDlgFn 콜백 함수(rasdlg.h)

  • 아티클

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

]

RasCustomDialDlg 함수는 타사 사용자 지정 전화 걸기 DLL에서 내보내는 애플리케이션 정의 함수입니다. 이 함수를 사용하면 타사 공급업체에서 사용자 지정 RAS 연결 대화 상자를 구현할 수 있습니다.

구문

RasCustomDialDlgFn Rascustomdialdlgfn;

BOOL Rascustomdialdlgfn(
  HINSTANCE hInstDll,
  DWORD dwFlags,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPWSTR lpszPhoneNumber,
  LPRASDIALDLG lpInfo,
  PVOID pvInfo
)
{...}

매개 변수

hInstDll

로드된 사용자 지정 전화 걸기 DLL의 instance 대한 핸들입니다.

dwFlags

RasCustomDialDlg 옵션을 지정하는 비트 플래그 집합입니다.

값 의미
RCD_Logon
 이 플래그를 하나로 설정하면 연결이 Windows 로그온 컨텍스트에서 전화를 걸었습니다. RasDial 은 이 정보를 사용하여 연결 항목에 대한 적절한 사용자 기본 설정을 가져옵니다. 이 진입점에서 RasDial을 호출하는 경우 lpRasDialExtension 매개 변수의 dwfOptions 멤버는 연결이 Windows 로그온 컨텍스트에서 전화를 걸었음을 나타내기 위해 RDEOPT_NoUser 플래그를 설정해야 합니다.
 

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 예약되어 있으며 사용하면 안 됩니다.

lpszPhonebook

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

lpszEntry

전화를 걸 전화 번호부 항목의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

lpszPhoneNumber

전화 번호 매기기 항목에 저장된 숫자를 재정의하는 전화 번호가 포함된 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL인 경우 RasDialDlg 는 전화 번호부 항목의 숫자를 사용합니다.

lpInfo

추가 입력 및 출력 매개 변수를 포함하는 RASDIALDLG 구조체에 대한 포인터입니다. 입력에서 이 구조체의 dwSize 멤버는 sizeof( RASDIALDLG)를 지정해야 합니다. 오류가 발생하면 dwError 멤버는 오류 코드를 반환합니다. 그렇지 않으면 0을 반환합니다.

pvInfo

내부용으로 예약된 속성입니다. 이 매개 변수는 항상 NULL입니다.

반환 값

사용자가 전화 번호부 항목을 만들거나 복사하거나 편집하는 경우 반환 값은 TRUE여야 합니다. 그렇지 않으면 함수는 FALSE를 반환해야 합니다.

오류가 발생하면 RasCustomEntryDlg는 RASENTRYDLG 구조체의 dwError 멤버를 라우팅 및 원격 액세스 오류 코드 또는 Winerror.h의 값으로 설정해야 합니다.

설명

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

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

사용자 지정 다이얼 대화 상자는 LOWORD(wParam)가 IDCANCEL과 같은 WM_COMMAND 메시지를 지원해야 합니다.

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

요구 사항

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

추가 정보

사용자 지정 전화 걸기

RASENTRY

RasCustomDial

RasCustomEntryDlg

RasCustomHangUp

RasDialDlg

RAS(원격 액세스 서비스) 개요

원격 액세스 서비스 함수