Función de devolución de llamada RasCustomScriptExecuteFn (ras.h)

RAS llama a la función RasCustomScriptExecute al establecer una conexión para una entrada de libreta de teléfonos que tenga establecida la opción RASEO_CustomScript .

Sintaxis

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
)
{...}

Parámetros

[in] hPort

Controle el puerto en el que se establece la conexión. Use este identificador al enviar o recibir datos en el puerto.

[in] lpszPhonebook

Puntero a una cadena Unicode que contiene la ruta de acceso a la libreta de teléfonos en la que reside la entrada de la conexión.

[in] lpszEntryName

Puntero a una cadena Unicode que contiene el nombre de la entrada que se marcó para establecer la conexión.

[in] pfnRasGetBuffer

Puntero a una función de tipo PFNRASGETBUFFER. El archivo DLL de scripting personalizado debe usar esta función para asignar memoria para enviar datos al servidor.

[in] pfnRasFreeBuffer

Puntero a una función de tipo PFNRASFREEBUFFER. El archivo DLL de scripting personalizado debe usar esta función para liberar memoria asignada por la función pfnRasGetBuffer .

[in] pfnRasSendBuffer

Puntero a una función de tipo PFNRASSENDBUFFER. El archivo DLL de scripting personalizado usa esta función para comunicarse con el servidor a través del puerto especificado.

[in] pfnRasReceiveBuffer

Puntero a una función de tipo PFNRASRECEIVEBUFFER. El archivo DLL de scripting personalizado usa esta función para comunicarse con el servidor a través del puerto especificado.

[in] pfnRasRetrieveBuffer

Puntero a una función de tipo PFNRASRETRIEVEBUFFER. El archivo DLL de scripting personalizado usa esta función para comunicarse con el servidor a través del puerto especificado.

[in] hWnd

Identificador de una ventana que el archivo DLL de scripting personalizado puede usar para presentar una interfaz de usuario al usuario.

[in] pRasDialParams

Puntero a una estructura RASDIALPARAMS unicode. Esta estructura contiene las credenciales de autenticación del usuario. El archivo DLL de scripting personalizado puede modificar los miembros szUserName, szPassword y szDomain de esta estructura. El Protocolo de punto a punto (PPP) usará lo que se almacene en estos miembros cuando RasCustomScriptExecute devuelva.

pvReserved

Valor devuelto

Si la función se realiza correctamente, el valor devuelto debe ser ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto debe ser un código de error adecuado de Winerror.h o Raserror.h.

Comentarios

Cuando RAS llama a RasCustomScriptExecute, el parámetro pRasDialParams apuntará a la estructura RASDIALPARAMS de Unicode. Es decir, la estructura solo contiene cadenas Unicode.

En algunos casos, szUserName de la estructura RASDIALPARAMS será una cadena vacía. En estos casos, el archivo DLL de scripting personalizado debe usar la versión Unicode de la función GetUserName para obtener el nombre del usuario actual.

Requisitos

Consulte también

Scripting personalizado de RAS

RasFreeBuffer

RasGetBuffer

RasReceiveBuffer

RasRetrieveBuffer

RasSendBuffer