Funzione di callback RasCustomDialDlgFn (rasdlg.h)
[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 |
|---|---|
|
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 |