RasPhonebookDlgA-Funktion (rasdlg.h)
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 |