RasPhonebookDlgA 函式 （rasdlg.h）

RasPhonebookDlg 函式會顯示主要 撥號網路 對話方塊。 在此強制回應對話框中，用戶可以撥打、編輯或刪除選取的電話簿專案、建立新的電話簿專案，或指定使用者喜好設定。 RasPhonebookDlg 函式會在對話框關閉時傳回。

語法

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

參數

[in] lpszPhonebook

null終止字串的指標，指定電話簿檔案的完整路徑和檔名。 如果此參數 NULL，則函式會使用目前的預設電話簿檔案。 默認的電話簿檔案是使用者在 [撥號網络] 對話框中 [使用者 喜好設定] 屬性表中選取的默認電話簿檔案。

[in] lpszEntry

null終止字串的指標，指定一開始要反白顯示之電話簿項目的名稱。 如果此參數 NULL，或指定的專案不存在，則對話框會反白顯示字母清單中的第一個專案。

[in, out] lpInfo

指定其他輸入和輸出參數之 RASPBDLG 結構的指標。

在輸入時，這個結構的 dwSize 成員必須指定 sizeof（RASPBDLG）。

如果發生錯誤，dwError 結構成員會在輸出時收到錯誤碼;否則，它會接收零。

傳回值

如果使用者選取 [Connect] 按鈕，且函式會建立連線，則傳回值會 TRUE。 否則，函式會傳回 FALSE。

如果發生錯誤，dwErrorRASPBDLG 結構的成員會從 路由和遠端訪問錯誤碼 或 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） 概觀

遠端訪問服務函式