Funzione di callback RasCustomDialDlgFn (rasdlg.h)

Articolo
03/01/2024

[Questa funzione non è disponibile a partire da Windows Server 2008.

]

La funzione RasCustomDialDlg è una funzione definita dall'applicazione esportata da una DLL personalizzata di terze parti. Questa funzione consente ai fornitori di terze parti di implementare finestre di dialogo di connessione RAS personalizzate.

Sintassi

RasCustomDialDlgFn Rascustomdialdlgfn;

BOOL Rascustomdialdlgfn(
  HINSTANCE hInstDll,
  DWORD dwFlags,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPWSTR lpszPhoneNumber,
  LPRASDIALDLG lpInfo,
  PVOID pvInfo
)
{...}

Parametri

hInstDll

Gestire l'istanza della DLL di composizione personalizzata caricata.

dwFlags

Set di flag di bit che specificano le opzioni RasCustomDialDlg .

Valore	Significato
RCD_Logon	Se questo flag è impostato su uno, la connessione è stata chiamata da un contesto di accesso di Windows. RasDial usa queste informazioni per ottenere le preferenze utente appropriate per la voce di connessione. Se RasDial viene chiamato da questo punto di ingresso, il membro dwfOptions del parametro lpRasDialExtension deve avere il flag RDEOPT_NoUser impostato per indicare che la connessione è stata chiamata da un contesto di accesso di Windows.

Valore

Significato

RCD_Logon

Se questo flag è impostato su uno, la connessione è stata chiamata da un contesto di accesso di Windows. RasDial usa queste informazioni per ottenere le preferenze utente appropriate per la voce di connessione. Se RasDial viene chiamato da questo punto di ingresso, il membro dwfOptions del parametro lpRasDialExtension deve avere il flag RDEOPT_NoUser impostato per indicare che la connessione è stata chiamata da un contesto di accesso di Windows.

Windows Server 2003 e Windows XP/2000: Questo parametro è riservato e non deve essere usato.

lpszPhonebook

Puntatore a una stringa con terminazione Null che specifica il percorso completo e il nome file di un file di rubrica telefonica (PBK). Se questo parametro è NULL, la funzione usa il file di rubrica predefinito corrente. Il file predefinito della rubrica telefonica è quello selezionato dall'utente nella finestra delle proprietà Preferenze utente della finestra di dialogo Rete remota.

lpszEntry

Puntatore a una stringa con terminazione Null contenente il nome della voce della rubrica telefonica da comporre.

lpszPhoneNumber

Puntatore a una stringa con terminazione Null contenente un numero di telefono che esegue l'override dei numeri archiviati nella voce della rubrica telefonica. Se questo parametro è NULL, RasDialDlg usa i numeri nella voce della rubrica telefonica.

lpInfo

Puntatore a una struttura RASDIALDLG che contiene parametri di input e output aggiuntivi. In input, il membro dwSize di questa struttura deve specificare sizeof( RASDIALDLG). Se si verifica un errore, il membro dwError restituisce un codice di errore; in caso contrario, restituisce zero.

pvInfo

Riservato per utilizzo interno. Questo parametro sarà sempre NULL.

Valore restituito

Se l'utente crea, copia o modifica una voce della rubrica telefonica, il valore restituito deve essere TRUE. In caso contrario, la funzione deve restituire FALSE.

Se si verifica un errore, RasCustomEntryDlg deve impostare il membro dwError della struttura RASENTRYDLG su un valore da Routing e Remote Access Error Codes o Winerror.h.

Commenti

RAS chiama questo punto di ingresso da RasDialDlg, se il membro szCustomDialDll della struttura RASENTRY per la voce da comporre specifica una DLL di composizione personalizzata.

Se questo punto di ingresso chiama RasDial, il parametro lpRasDialExtensions non deve essere NULL e il membro dwfOptions della struttura RASDIALEXTENSIONS deve avere il flag RDEOPT_CustomDial impostato.

La finestra di dialogo di composizione personalizzata deve supportare WM_COMMAND messaggi in cui LOWORD(wParam) è uguale a IDCANCEL.

Se la DLL con composizione personalizzata non supporta questo punto di ingresso, RAS restituisce ERROR_CANNOT_DO_CUSTOMDIAL al chiamante di RasDialDlg.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rasdlg.h