WapRead

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function reads a packet.

Syntax

HRESULT WapRead(
  const WAP_HANDLE whHandle,
  WAP_PRIMITIVE_BASE* const pwpbPrimitiveBuffer,
  const DWORD dwPrimitiveBufferSize 
);

Parameters

  • whHandle
    [in] The WAP handle retrieved by the WapOpen function.
  • pwpbPrimitiveBuffer
    [out] Pointer to a buffer containing a layer-specific structure of type WAP_PRIMITIVE_BASE. All PDUs are derived from the WAP_PRIMITIVE_BASE structure. If the buffer indicated by this parameter is too small to hold the primitive, the function will return E_FAIL.
  • dwPrimitiveBufferSize
    [in] The size, in bytes, of the buffer indicated by pwpbPrimitiveBuffer. This value can be obtained by calling WapGetNextPrimitiveSize.

Return Value

Returns S_OK if successful. If unsuccessful, this function returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL.

Requirements

Header wap.h
Library Wap.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

WapOpen
WapGetNextPrimitiveSize
WAP_PRIMITIVE_BASE

Concepts

WAP Functions