RasPhonebookDlgA 함수(rasdlg.h)
RasPhonebookDlg 함수는 기본 전화 접속 네트워킹 대화 상자를 표시합니다. 이 모달 대화 상자에서 사용자는 선택한 전화 번호부 항목을 다이얼, 편집 또는 삭제하거나, 새 전화 번호부 항목을 만들거나, 사용자 기본 설정을 지정할 수 있습니다. RasPhonebookDlg 함수는 대화 상자가 닫히면 를 반환합니다.
구문
BOOL RasPhonebookDlgA(
[in] LPSTR lpszPhonebook,
[in] LPSTR lpszEntry,
[in, out] LPRASPBDLGA lpInfo
);
매개 변수
[in] lpszPhonebook
전화 번호부(PBK) 파일의 전체 경로 및 파일 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL인 경우 함수는 현재 기본 전화 번호부 파일을 사용합니다. 기본 전화 번호부 파일은 전화 접속 네트워킹 대화 상자의 사용자 기본 설정 속성 시트에서 사용자가 선택한 파일입니다.
[in] lpszEntry
처음에 강조 표시할 전화 번호부 항목의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이거나 지정된 항목이 없는 경우 대화 상자에 알파벳 목록의 첫 번째 항목이 강조 표시됩니다.
[in, out] lpInfo
추가 입력 및 출력 매개 변수를 지정하는 RASPBDLG 구조체에 대한 포인터입니다.
입력에서 이 구조체의 dwSize 멤버는 sizeof( RASPBDLG)를 지정해야 합니다.
오류가 발생하면 구조체의 dwError 멤버는 출력 시 오류 코드를 받습니다. 그렇지 않으면 0을 받습니다.
반환 값
사용자가 연결 단추를 선택하고 함수가 연결을 설정하는 경우 반환 값은 TRUE입니다. 그렇지 않으면 함수는 FALSE를 반환 합니다.
오류가 발생하면 RASPBDLG 구조체의 dwError 멤버는 라우팅 및 원격 액세스 오류 코드 또는 Winerror.h의 값을 반환합니다.
다음 샘플 코드는 전화 접속 네트워킹 대화 상자를 표시합니다. 대화 상자에는 기본 전화 번호부 파일의 첫 번째 항목에 대한 전화 걸기 정보가 표시됩니다.
#include <windows.h>
#include <stdio.h>
#include "ras.h"
#include "rasdlg.h"
#pragma comment(lib, "rasapi32.lib")
int main (){
// Initialize the return code
BOOL nRet = TRUE;
// Allocate heap memory for the RASPBLDG structure
RASPBDLG * lpInfo = (LPRASPBDLG)HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(RASPBDLG));
// The dwsize member of lpInfo must contain the structure size, or the
// call to RasPhonebookDlg will fail
lpInfo->dwSize = sizeof(RASPBDLG);
// Open a user dialog box
nRet = RasPhonebookDlg(NULL,NULL,lpInfo);
if(nRet == TRUE){
// The user dialed a connection successfully
printf("User pressed Connect\n");
}else{
if(lpInfo->dwError != 0){
printf("RasPhonebookDlg failed: Error = %d\n", lpInfo->dwError);
}else{
// The user closed the dialog box manually
printf("User pressed Close\n");
}
}
// Free the heap memory for the RASPBLDG structure
HeapFree(GetProcessHeap(), 0, lpInfo);
return 0;
}
설명
참고
rasdlg.h 헤더는 RAsPhonebookDlg를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | rasdlg.h |
라이브러리 | Rasdlg.lib |
DLL | Rasdlg.dll |