RasPhonebookDlg

BOOL RasPhonebookDlg(
  _In_    LPTSTR     lpszPhonebook,
  _In_    LPTSTR     lpszEntry,
  _Inout_ LPRASPBDLG lpInfo
);

说明

该函数用户显示模式化的拨号网络对话框主窗口。用户可以进行拨号、创建、编辑或删除电话簿条目，或者修改偏好设置。当主窗口关闭时函数才会返回。

参数

lpszPhonebook [in]

指向一个包含完整路径的电话簿文件(PBK)。如果参数为空，则该函数使用默认的电话簿文件。默认的电话簿文件由用户在拨号网络对话框的[user preferences]属性窗口中选择。

lpszEntry [in]

指定一个初始高亮显示的电话簿条目名称。该参数为空或者条目名称不存在时，对话框高亮显示第一个按字母表排序的条目名称。

lpInfo [in, out]

指向一个RASPBDLG结构，用于指定额外的输入输出参数。

调用前设置lpInfo->dwSize成员值为sizeof(RASPBDLG)。

当有错误发生时，lpInfo->dwError接收错误代码。

返回值

当用户进行拨号建立连接后，该函数返回TRUE，否则返回FALSE。

当有错误发生时，lpInfo->dwError接收来自Routing and Remote Access Error Codes或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;
}

系统支持

客户端最小支持	Windows 2000 专业版
服务端最小支持	Windows 2000 Server
Header	Rasdlg.h
Library	Rasdlg.lib
DLL	Rasdlg.dll
Unicode和ANSI名称	RasPhonebookDlgW(Unicode)和RasPhonebookDlg(ANSI)