Funzione di callback RasCustomDialFn (ras.h)

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

]

La funzione RasCustomDial è una funzione definita dall'applicazione esportata da una DLL personalizzata di terze parti. Questa funzione consente ai fornitori di terze parti di implementare routine di accesso remoto personalizzate.

Sintassi

RasCustomDialFn Rascustomdialfn;

DWORD Rascustomdialfn(
  HINSTANCE hInstDll,
  LPRASDIALEXTENSIONS lpRasDialExtensions,
  LPCWSTR lpszPhonebook,
  LPRASDIALPARAMS lpRasDialParams,
  DWORD dwNotifierType,
  LPVOID lpvNotifier,
  LPHRASCONN lphRasConn,
  DWORD dwFlags
)
{...}

Parametri

hInstDll

Gestire l'istanza della DLL di chiamata personalizzata caricata.

lpRasDialExtensions

Puntatore a una struttura RASDIALEXTENSIONS che specifica un set di funzionalità estese rasDial da abilitare. Impostare questo parametro su NULL se non è necessario abilitare le estensioni.

lpszPhonebook

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

lpRasDialParams

Puntatore a una struttura RASDIALPARAMS che specifica i parametri chiamanti per la connessione RAS.

Il chiamante deve impostare il membro dwSize della struttura RASDIALPARAMS su sizeof(RASDIALPARAMS) per identificare la versione della struttura passata.

dwNotifierType

Questo parametro è lo stesso del parametro dwNotifierType per la funzione RasDial . Per altre informazioni, vedere la pagina di riferimento rasDial .

lpvNotifier

Questo parametro è lo stesso del parametro lpvNotifier per la funzione RasDial . Per altre informazioni, vedere la pagina di riferimento rasDial .

lphRasConn

Puntatore a una variabile di tipo HRASCONN. Impostare la variabile HRASCONN su NULL prima di chiamare RasDial. Se RasDial ha esito positivo, archivia un handle per la connessione RAS in *lphRasConn.

dwFlags

Questo parametro riservato per l'uso futuro.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS e viene restituito un handle per la connessione RAS nella variabile a cui punta il parametro lphRasConn .

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore da Routing e codici di errore di accesso remoto o Winerror.h.

Valore Significato
ERROR_NOT_ENOUGH_MEMORY
La funzione non ha potuto allocare memoria sufficiente per completare l'operazione.

Commenti

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

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

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

Requisiti

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

Vedi anche

Dialer personalizzati

RASENTRY

RasCustomDialDlg

RasCustomEntryDlg

RasCustomHangUp

RasDial

Panoramica del servizio di accesso remoto (RAS)

Funzioni del Servizio di accesso remoto