Compartir a través de

RasGetBuffer

  • Artículo

This function allocates memory for sending or receiving data over the port connected to the server. A custom-scripting DLL, which is implemented by the developer, calls RasGetBuffer through a function pointer. RAS passes the function pointer through the phnRasGetBuffer parameter of the DLL's RasCustomScriptExecute function.

typedef DWORD (APIENTRY *PFNRASGETBUFFER)(
  PBYTE* ppBuffer, 
  PDWORD pdwSize 
);

Parameters

  • ppBuffer
    Pointer to a pointer that receives the address of the returned buffer.
  • pdwSize
    Pointer to a DWORD variable that, on input, contains the requested size of the buffer. On output, this variable contains the actual size of the buffer allocated.

Return Values

  • ERROR_SUCCESS
    The function was successful.
  • ERROR_BUFFER_INVALID
    The pointer to the buffer passed in the ppBuffer parameter is invalid.

Remarks

The maximum buffer size that can be allocated is 1500 bytes.

The custom-scripting DLL calls RasGetBuffer through a function pointer.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Ras.h.
Link Library: Ppp.lib.

See Also

RAS Custom Scripting | RasCustomScriptExecute | RasFreeBuffer

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.