Función de devolución de llamada PFNRASRECEIVEBUFFER (ras.h)
El archivo DLL de scripting personalizado llama a la función RasReceiveBuffer para informar a RAS de que está listo para recibir datos del servidor a través del puerto especificado.
El tipo PFNRASRECEIVEBUFFER define un puntero a esta función de devolución de llamada. RasReceiveBuffer es un marcador de posición para el nombre de la función definida por la aplicación.
Sintaxis
PFNRASRECEIVEBUFFER Pfnrasreceivebuffer;
DWORD Pfnrasreceivebuffer(
HANDLE hPort,
PBYTE pBuffer,
PDWORD pdwSize,
DWORD dwTimeOut,
HANDLE hEvent
)
{...}
Parámetros
hPort
Identificador del puerto en el que se van a recibir los datos. Este identificador debe ser el identificador pasado por RAS como primer parámetro de la función RasCustomScriptExecute .
pBuffer
Puntero a un búfer para recibir los datos del puerto especificado por el parámetro hPort . Obtenga este búfer mediante la función RasGetBuffer .
pdwSize
Puntero a una variable DWORD que recibe el tamaño de los datos devueltos en el búfer al que apunta el parámetro pBuffer .
dwTimeOut
hEvent
Identificador de un objeto de evento que RAS señalará cuando los datos recibidos estén disponibles.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto se ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
El puntero al búfer pasado en el parámetro pBuffer no es válido. |
|
El identificador especificado por el parámetro hPort no es válido. |
Comentarios
RasReceiveBuffer es una función asincrónica. RasReceiveBuffer devuelve inmediatamente incluso si los datos aún no están disponibles. El archivo DLL de scripting personalizado debe esperar en el objeto de evento especificado por el parámetro hEvent . Cuando los datos están disponibles, RAS señala este evento. A continuación, el archivo DLL de scripting personalizado debe llamar a la función RasRetrieveBuffer para obtener los datos. El archivo DLL de scripting personalizado puede pasar el mismo puntero de búfer en RasRetrieveBuffer que pasó en RasReceiveBuffer.
RAS también indica el objeto de evento si, por algún motivo, el puerto se desconecta antes de que se publiquen los datos. En este caso, RasRetrieveBuffer devuelve un error definido en Raserror.h, que indica la causa del error.
El archivo DLL de scripting personalizado llama a RasReceiveBuffer a través de un puntero de función. El puntero de función se pasa al archivo DLL de scripting personalizado como parámetro cuando RAS llama a la implementación del archivo DLL de RasCustomScriptExecute.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | ras.h |