RasCustomEntryDlgFn 콜백 함수(rasdlg.h)

아티클
08/25/2023

RasCustomEntryDlg 함수는 타사 사용자 지정 전화 걸기 DLL에서 내보내는 애플리케이션 정의 함수입니다. 이 함수를 사용하면 타사 공급업체가 전화 번호부 항목을 관리하기 위한 사용자 지정 대화 상자를 구현할 수 있습니다.

구문

RasCustomEntryDlgFn Rascustomentrydlgfn;

BOOL Rascustomentrydlgfn(
  HINSTANCE hInstDll,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPRASENTRYDLG lpInfo,
  DWORD dwFlags
)
{...}

매개 변수

hInstDll

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

lpszPhonebook

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

lpszEntry

편집, 복사 또는 만들 전화 번호부 항목의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

항목을 편집하거나 복사하는 경우 이 매개 변수는 기존 전화 번호부 항목의 이름입니다. 항목을 복사하는 경우 RASENTRYDLG 구조체의 dwFlags 멤버에서 RASEDFLAG_CloneEntry 플래그를 설정합니다.

항목을 만드는 경우 이 매개 변수는 사용자가 변경할 수 있는 기본 새 항목 이름입니다. 이 매개 변수가 NULL인 경우 함수는 기본 이름을 제공합니다. 항목을 만드는 경우 RASENTRYDLG 구조체의 dwFlags 멤버에서 RASEDFLAG_NewEntry 플래그를 설정합니다.

lpInfo

추가 입력 및 출력 매개 변수를 포함하는 RASENTRYDLG 구조체에 대한 포인터입니다. 입력 시 이 구조체의 dwSize 멤버는 sizeof( RASENTRYDLG)를 지정해야 합니다. dwSize 멤버를 사용하여 항목을 만들거나 편집하거나 복사할지 여부를 나타냅니다. 오류가 발생하면 dwError 멤버가 오류 코드를 반환합니다. 그렇지 않으면 0을 반환합니다.

dwFlags

다음에 사용하도록 예약됩니다.

반환 값

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

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

설명

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

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

요구 사항

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