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

추가 정보

RASPBDLG

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

원격 액세스 서비스 함수