Funzione di callback RasCustomScriptExecuteFn (ras.h)

Articolo
03/05/2024

RAS chiama la funzione RasCustomScriptExecute quando si stabilisce una connessione per una voce di rubrica con l'opzione RASEO_CustomScript impostata.

Sintassi

RasCustomScriptExecuteFn Rascustomscriptexecutefn;

DWORD Rascustomscriptexecutefn(
  [in] HANDLE hPort,
  [in] LPCWSTR lpszPhonebook,
  [in] LPCWSTR lpszEntryName,
  [in] PFNRASGETBUFFER pfnRasGetBuffer,
  [in] PFNRASFREEBUFFER pfnRasFreeBuffer,
  [in] PFNRASSENDBUFFER pfnRasSendBuffer,
  [in] PFNRASRECEIVEBUFFER pfnRasReceiveBuffer,
  [in] PFNRASRETRIEVEBUFFER pfnRasRetrieveBuffer,
  [in] HWND hWnd,
  [in] RASDIALPARAMS *pRasDialParams,
       PVOID pvReserved
)
{...}

Parametri

[in] hPort

Gestire la porta in cui viene stabilita la connessione. Usare questo handle quando si inviano o ricevono dati sulla porta.

[in] lpszPhonebook

Puntatore a una stringa Unicode che contiene il percorso della rubrica in cui risiede la voce per la connessione.

[in] lpszEntryName

Puntatore a una stringa Unicode contenente il nome della voce che è stata chiamata per stabilire la connessione.

[in] pfnRasGetBuffer

Puntatore a una funzione di tipo PFNRASGETBUFFER. La DLL di scripting personalizzata deve usare questa funzione per allocare memoria per inviare dati al server.

[in] pfnRasFreeBuffer

Puntatore a una funzione di tipo PFNRASFREEBUFFER. La DLL di scripting personalizzata deve usare questa funzione per liberare memoria allocata dalla funzione pfnRasGetBuffer .

[in] pfnRasSendBuffer

Puntatore a una funzione di tipo PFNRASSENDBUFFER. La DLL di scripting personalizzata usa questa funzione per comunicare con il server sulla porta specificata.

[in] pfnRasReceiveBuffer

Puntatore a una funzione di tipo PFNRASRECEIVEBUFFER. La DLL di scripting personalizzata usa questa funzione per comunicare con il server sulla porta specificata.

[in] pfnRasRetrieveBuffer

Puntatore a una funzione di tipo PFNRASRETRIEVEBUFFER. La DLL di scripting personalizzata usa questa funzione per comunicare con il server sulla porta specificata.

[in] hWnd

Gestire in una finestra che la DLL di scripting personalizzata può usare per presentare un'interfaccia utente all'utente.

[in] pRasDialParams

Puntatore a una struttura RASDIALPARAMS Unicode. Questa struttura contiene le credenziali di autenticazione per l'utente. La DLL di scripting personalizzata può modificare i membri szUserName, szPassword e szDomain di questa struttura. Il protocollo PPP (Point-to-Point Protocol) userà qualsiasi elemento archiviato in questi membri quando viene restituito RasCustomScriptExecute .

pvReserved

Valore restituito

Se la funzione ha esito positivo, il valore restituito deve essere ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito deve essere un codice di errore appropriato da Winerror.h o Raserror.h.

Commenti

Quando RAS chiama RasCustomScriptExecute, il parametro pRasDialParams punterà alla struttura UNICODE RASDIALPARAMS . Ovvero, la struttura contiene solo stringhe Unicode.

In alcuni casi, szUserName della struttura RASDIALPARAMS sarà una stringa vuota. In questi casi, la DLL di scripting personalizzata deve usare la versione Unicode della funzione GetUserName per ottenere il nome dell'utente corrente.

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	ras.h