Função de retorno de chamada PFNRASGETBUFFER (ras.h)

  • Artigo

A DLL de script personalizado chama RasGetBuffer para alocar memória para enviar ou receber dados pela porta conectada ao servidor.

Sintaxe

PFNRASGETBUFFER Pfnrasgetbuffer;

DWORD Pfnrasgetbuffer(
  PBYTE *ppBuffer,
  PDWORD pdwSize
)
{...}

Parâmetros

ppBuffer

Ponteiro para um ponteiro que recebe o endereço do buffer retornado.

pdwSize

Ponteiro para uma variável DWORD que, na entrada, contém o tamanho solicitado do buffer. Na saída, essa variável contém o tamanho real do buffer alocado.

Valor retornado

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será o código de erro a seguir.

Valor Significado
ERROR_OUT_OF_BUFFERS
 O RAS não pode alocar mais espaço em buffer.

Comentários

O tamanho máximo do buffer que pode ser obtido é de 1500 bytes.

A DLL de script personalizado chama RasGetBuffer por meio de um ponteiro de função. O ponteiro de função é passado para a DLL de script personalizado como um parâmetro quando RAS chama a implementação da DLL de RasCustomScriptExecute.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ras.h

Confira também

Script personalizado ras

RasCustomScriptExecute

RasFreeBuffer