Fonction de rappel RasCustomScriptExecuteFn (ras.h)
RAS appelle la fonction RasCustomScriptExecute lors de l’établissement d’une connexion pour une entrée de carnet de téléphone pour laquelle l’option RASEO_CustomScript est définie.
Syntaxe
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
)
{...}
Paramètres
[in] hPort
Gérez le port sur lequel la connexion est établie. Utilisez ce handle lors de l’envoi ou de la réception de données sur le port.
[in] lpszPhonebook
Pointeur vers une chaîne Unicode qui contient le chemin d’accès à l’annuaire téléphonique dans lequel réside l’entrée de la connexion.
[in] lpszEntryName
Pointeur vers une chaîne Unicode qui contient le nom de l’entrée qui a été compose pour établir la connexion.
[in] pfnRasGetBuffer
Pointeur vers une fonction de type PFNRASGETBUFFER. La DLL de script personnalisé doit utiliser cette fonction pour allouer de la mémoire afin d’envoyer des données au serveur.
[in] pfnRasFreeBuffer
Pointeur vers une fonction de type PFNRASFREEBUFFER. La DLL de script personnalisé doit utiliser cette fonction pour libérer de la mémoire allouée par la fonction pfnRasGetBuffer .
[in] pfnRasSendBuffer
Pointeur vers une fonction de type PFNRASSENDBUFFER. La DLL de script personnalisé utilise cette fonction pour communiquer avec le serveur sur le port spécifié.
[in] pfnRasReceiveBuffer
Pointeur vers une fonction de type PFNRASRECEIVEBUFFER. La DLL de script personnalisé utilise cette fonction pour communiquer avec le serveur sur le port spécifié.
[in] pfnRasRetrieveBuffer
Pointeur vers une fonction de type PFNRASRETRIEVEBUFFER. La DLL de script personnalisé utilise cette fonction pour communiquer avec le serveur sur le port spécifié.
[in] hWnd
Gérez une fenêtre que la DLL de script personnalisé peut utiliser pour présenter une interface utilisateur à l’utilisateur.
[in] pRasDialParams
Pointeur vers une structure UNICODE RASDIALPARAMS . Cette structure contient les informations d’identification d’authentification de l’utilisateur. La DLL de script personnalisé peut modifier les membres szUserName, szPassword et szDomain de cette structure. Le protocole PPP (Point-to-Point Protocol) utilise tout ce qui est stocké dans ces membres lorsque RasCustomScriptExecute est retourné.
pvReserved
Valeur retournée
Si la fonction réussit, la valeur de retour doit être ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour doit être un code d’erreur approprié de Winerror.h ou Raserror.h.
Remarques
Lorsque RAS appelle RasCustomScriptExecute, le paramètre pRasDialParams pointe vers la structure Unicode RASDIALPARAMS . Autrement dit, la structure contient uniquement des chaînes Unicode.
Dans certains cas, le szUserName de la structure RASDIALPARAMS est une chaîne vide. Dans ce cas, la DLL de script personnalisé doit utiliser la version Unicode de la fonction GetUserName pour obtenir le nom de l’utilisateur actuel.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ras.h |