通过

RasPhonebookDlgA 函数 （rasdlg.h）

  • 项目

RasPhonebookDlg 函数显示主 拨号网络 对话框。 在此模式对话框中，用户可以拨号、编辑或删除所选电话簿条目、创建新的电话簿条目或指定用户首选项。 对话框关闭时，RasPhonebookDlg 函数返回。

语法

BOOL RasPhonebookDlgA(
  [in]      LPSTR       lpszPhonebook,
  [in]      LPSTR       lpszEntry,
  [in, out] LPRASPBDLGA lpInfo
);

参数

[in] lpszPhonebook

指向 null终止字符串的指针，该字符串指定电话簿 （PBK） 文件的完整路径和文件名。 如果此参数 NULL，则该函数使用当前的默认电话簿文件。 默认电话簿文件是用户在 用户首选项拨号网络 对话框中选择的文件。

[in] lpszEntry

指向 null-terminated 字符串的指针，该字符串指定最初要突出显示的电话簿条目的名称。 如果此参数 NULL，或者指定条目不存在，则对话框突出显示字母列表中的第一个条目。

[in, out] lpInfo

指向指定其他输入和输出参数的 RASPBDLG 结构的指针。

在输入时，此结构的 dwSize 成员必须指定 sizeof（RASPBDLG）。

如果发生错误，则结构 dwError 成员在输出时收到错误代码;否则，它将接收零。

返回值

如果用户选择“Connect”按钮，并且函数建立连接，则返回值 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 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 rasdlg.h
库 Rasdlg.lib
DLL Rasdlg.dll

另请参阅

RASPBDLG

远程访问服务（RAS）概述

远程访问服务函数