RasPhonebookDlgA-Funktion (rasdlg.h)

Artikel
08/25/2023

Die RasPhonebookDlg-Funktion zeigt das Dialogfeld Standard DFÜ-Netzwerk an. In diesem modalen Dialogfeld kann der Benutzer einen ausgewählten Telefonbucheintrag wä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

Zeiger auf eine NULL-endende Zeichenfolge, die den vollständigen Pfad und Dateinamen einer Telefonbuchdatei (PBK) angibt. Wenn dieser Parameter NULL ist, verwendet die Funktion die aktuelle Standardtelefonbuchdatei. Die Standardmäßige Telefonbuchdatei wird vom Benutzer im Eigenschaftenblatt Benutzereinstellungen des DialogfeldsDFÜ-Netzwerk ausgewählt.

[in] lpszEntry

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Telefonbucheintrags angibt, der anfänglich hervorgehoben werden soll. Wenn dieser Parameter NULL ist oder der angegebene Eintrag nicht vorhanden ist, wird im Dialogfeld der erste Eintrag in der alphabetischen Liste hervorgehoben.

[in, out] lpInfo

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

Bei der Eingabe muss der dwSize-Member dieser Struktur die sizeof( RASPBDLG) angeben.

Wenn ein Fehler auftritt, empfängt der dwError-Member der -Struktur bei der Ausgabe einen Fehlercode. Andernfalls empfängt 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 FALSE zurück.

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

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

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

Hinweise

Hinweis

Der rasdlg.h-Header definiert RasPhonebookDlg als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rasdlg.h
Bibliothek	Rasdlg.lib
DLL	Rasdlg.dll

Weitere Informationen

RASPBDLG

Übersicht über ras (Remote Access Service, RAS)

Funktionen des RAS-Diensts

Share via