RasPhonebookDlgA-Funktion (rasdlg.h)

Artikel
11/20/2024

Die RasPhonebookDlg--Funktion zeigt das Hauptdialogfeld DFÜ-Netzwerk an. In diesem modalen Dialogfeld kann der Benutzer einen ausgewählten Telefonbucheintrag auswählen, bearbeiten oder löschen, einen neuen Telefonbucheintrag erstellen oder Benutzereinstellungen angeben. Die RasPhonebookDlg--Funktion gibt zurück, wenn das Dialogfeld geschlossen wird.

Syntax

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

Parameter

[in] lpszPhonebook

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die den vollständigen Pfad und Dateinamen einer PbK-Datei (Phone-Book) angibt. Wenn dieser Parameter NULL-ist, verwendet die Funktion die aktuelle Standarddatei des Telefonbuchs. Die Standardmäßige Telefonbuchdatei ist die vom Benutzer im Eigenschaftenblatt Benutzereinstellungen Eigenschaftenblatt des Dialogfelds DFÜ-Netzwerk ausgewählt.

[in] lpszEntry

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die den Namen des zu markierenden Telefonbucheintrags angibt. Wenn dieser Parameter NULL-ist oder der angegebene Eintrag nicht vorhanden ist, markiert das Dialogfeld den ersten Eintrag in der alphabetischen Liste.

[in, out] lpInfo

Zeiger auf die RASPBDLG Struktur, die zusätzliche Eingabe- und Ausgabeparameter angibt.

Bei eingaben muss das dwSize Member dieser Struktur die Größe( RASPBDLG) angeben.

Wenn ein Fehler auftritt, empfängt das dwError- Element der Struktur bei der Ausgabe einen Fehlercode; andernfalls erhält sie Null.

Rückgabewert

Wenn der Benutzer die Schaltfläche Verbinden auswählt und die Funktion eine Verbindung herstellt, ist der Rückgabewert TRUE. Andernfalls gibt die Funktion FALSEzurück.

Wenn ein Fehler auftritt, gibt das dwError Member der RASPBDLG- Struktur einen Wert aus Routing- und Remotezugriffsfehlercodes oder Winerror.h zurück.

Der folgende Beispielcode zeigt das Dialogfeld DFÜ-Netzwerk an. Im Dialogfeld werden Wählinformationen für den ersten Eintrag aus der Standardtelefonbuchdatei angezeigt.

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

Bemerkungen

Anmerkung

Der rasdlg.h-Header definiert RasPhonebookDlg als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	rasdlg.h
Library	Rasdlg.lib
DLL-	Rasdlg.dll

Siehe auch

RASPBDLG-

übersicht über Ras(Remote Access Service)

Remotezugriffsdienstfunktionen

Freigeben über