Función de devolución de llamada PFNRASRETRIEVEBUFFER (ras.h)
El archivo DLL de scripting personalizado llama a la función RasRetrieveBuffer para obtener los datos recibidos del servidor RAS a través del puerto especificado. El archivo DLL de scripting personalizado debe llamar a RasRetrieveBuffer solo después de que RAS haya señalado el objeto de evento pasado en la llamada a RasReceiveBuffer.
El tipo PFNRASRETRIEVEBUFFER define un puntero a esta función de devolución de llamada. RasRetrieveBuffer es un marcador de posición para el nombre de función definido por la aplicación.
Sintaxis
PFNRASRETRIEVEBUFFER Pfnrasretrievebuffer;
DWORD Pfnrasretrievebuffer(
HANDLE hPort,
PBYTE pBuffer,
PDWORD pdwSize
)
{...}
Parámetros
hPort
Controle el 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 . El valor de este parámetro puede ser el mismo que el puntero al búfer pasado a la función RasReceiveBuffer .
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 .
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es 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. |
RAS indica el objeto de evento si el puerto se desconecta por algún motivo antes de que se publiquen los datos. En este caso, RasRetrieveBuffer devuelve un error definido en Raserror.h, que indica la causa del error.
Comentarios
La función RasRetrieveBuffer es sincrónica. Cuando devuelve, el búfer al que apunta el parámetro pBuffer contiene los datos recibidos sobre el puerto especificado. El archivo DLL de scripting personalizado debe llamar a RasRetrieveBuffer solo después de que RAS haya señalado el objeto de evento que el archivo DLL pasó en la llamada a RasReceiveBuffer.
El archivo DLL de scripting personalizado llama a RasRetrieveBuffer 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
| Requisito | Value |
|---|---|
| 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 |