RasCustomEntryDlgFn-Rückruffunktion (rasdlg.h)

Artikel
08/25/2023

Die RasCustomEntryDlg-Funktion ist eine anwendungsdefinierte Funktion, die von einer benutzerdefinierten Wähl-DLL eines Drittanbieters exportiert wird. Mit dieser Funktion können Drittanbieter benutzerdefinierte Dialoge zum Verwalten von Telefonbucheinträgen implementieren.

Syntax

RasCustomEntryDlgFn Rascustomentrydlgfn;

BOOL Rascustomentrydlgfn(
  HINSTANCE hInstDll,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPRASENTRYDLG lpInfo,
  DWORD dwFlags
)
{...}

Parameter

hInstDll

Behandeln Sie die instance der dll für benutzerdefinierte Wählzeichen, die geladen wurde.

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.

lpszEntry

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des zu bearbeitenden, zu kopierenden oder zu erstellenden Telefonbucheintrags enthält.

Wenn Sie einen Eintrag bearbeiten oder kopieren, ist dieser Parameter der Name eines vorhandenen Telefonbucheintrags. Wenn Sie einen Eintrag kopieren, legen Sie das flag RASEDFLAG_CloneEntry im dwFlags-Element der RASENTRYDLG-Struktur fest.

Wenn Sie einen Eintrag erstellen, ist dieser Parameter ein neuer Standardeintragsname, den der Benutzer ändern kann. Wenn dieser Parameter NULL ist, stellt die Funktion einen Standardnamen bereit. Wenn Sie einen Eintrag erstellen, legen Sie das flag RASEDFLAG_NewEntry im dwFlags-Element der RASENTRYDLG-Struktur fest.

lpInfo

Zeiger auf eine RASENTRYDLG-Struktur , die zusätzliche Eingabe- und Ausgabeparameter enthält. Bei der Eingabe muss der dwSize-Member dieser Struktur sizeof( RASENTRYDLG) angeben. Verwenden Sie den dwSize-Member , um anzugeben, ob ein Eintrag erstellt, bearbeitet oder kopiert wird. Wenn ein Fehler auftritt, gibt der dwError-Member einen Fehlercode zurück. Andernfalls wird 0 (null) zurückgegeben.

dwFlags

Für die zukünftige Verwendung reserviert.

Rückgabewert

Wenn der Benutzer einen Telefonbucheintrag erstellt, kopiert oder bearbeitet, sollte der Rückgabewert TRUE sein. Andernfalls sollte die Funktion FALSE zurückgeben.

Wenn ein Fehler auftritt, sollte RasCustomEntryDlg den dwError-Member der RASENTRYDLG-Struktur auf einen Wert aus Routing- und RAS-Fehlercodes oder Winerror.h festlegen.

Hinweise

RAS ruft diesen Einstiegspunkt von RasEntryDlg auf, wenn der szCustomDialDll-Member der RASENTRY-Struktur für den gewählten Eintrag eine benutzerdefinierte Wähl-DLL angibt.

Wenn die DLL für benutzerdefinierte Wählzeichen diesen Einstiegspunkt nicht unterstützt, gibt RAS ERROR_NO_CUSTOMENTRYDLG an den Aufrufer von RasEntryDlg zurück.

Anforderungen

Anforderung	Wert
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