Fungsi RasPhonebookDlgA (rasdlg.h)

Fungsi RasPhonebookDlg menampilkan kotak dialog Jaringan Dial-Up utama. Dari kotak dialog modal ini, pengguna dapat memanggil, mengedit, atau menghapus entri buku telepon yang dipilih, membuat entri buku telepon baru, atau menentukan preferensi pengguna. Fungsi RasPhonebookDlg kembali saat kotak dialog ditutup.

Sintaks

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

Parameter

[in] lpszPhonebook

Penunjuk ke string yang dihentikan null yang menentukan jalur lengkap dan nama file file buku telepon (PBK). Jika parameter ini NULL, fungsi menggunakan file buku telepon default saat ini. File buku telepon default adalah file yang dipilih oleh pengguna di lembar properti Preferensi Pengguna dari kotak dialog Jaringan Dial-Up .

[in] lpszEntry

Penunjuk ke string yang dihentikan null yang menentukan nama entri buku telepon untuk disorot pada awalnya. Jika parameter ini NULL, atau jika entri yang ditentukan tidak ada, kotak dialog menyoroti entri pertama dalam daftar alfabet.

[in, out] lpInfo

Arahkan ke struktur RASPBDLG yang menentukan parameter input dan output tambahan.

Pada input, anggota dwSize dari struktur ini harus menentukan sizeof ( RASPBDLG).

Jika terjadi kesalahan, anggota dwError struktur menerima, pada output, kode kesalahan; jika tidak, ia menerima nol.

Menampilkan nilai

Jika pengguna memilih tombol Sambungkan dan fungsi membuat koneksi, nilai yang dikembalikan adalah TRUE. Jika tidak, fungsi mengembalikan FALSE.

Jika terjadi kesalahan, anggota dwError dari struktur RASPBDLG mengembalikan nilai dari Kode Kesalahan Perutean dan Akses Jarak Jauh atau Winerror.h.

Kode sampel berikut memunculkan dialog Jaringan Dial-Up . Dialog menampilkan informasi panggilan untuk entri pertama dari file buku telepon default.

#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;
}

Keterangan

Catatan

Header rasdlg.h mendefinisikan RasPhonebookDlg sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header rasdlg.h
Pustaka Rasdlg.lib
DLL Rasdlg.dll

Lihat juga

RASPBDLG

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Layanan Akses Jarak Jauh