XXX_Read (Compact 2013)

3/26/2014

This function reads the entire message and fills in provider-specific fields.

Syntax

HRESULT XXX_Read(
  SMS_MANAGER_COOKIE smsmcCookie,
  SMSSTOREITEM* psmssiMessage,
  BYTE* pbBuffer,
  DWORD dwBufferSize,
  BYTE* pbProviderSpecificBuffer,
  DWORD dwProviderSpecificBufferSize,
  SMS_MANAGER_GET_NEXT_MESSAGE smsmgnmGetNextMessageFunction,
  DWORD* pdwBytesRead
);

Parameters

• smsmcCookie
  [in] Value passed to the function that is specified in smsmgnmGetNextMessageFunction.

• psmssiMessage
  [in] Pointer to a SMSSTOREITEM structure. This structure contains the first message of a multipart message and determines the length of the entire message.

• pbBuffer
  [out] Buffer that stores the body of the message.

• dwBufferSize
  [in] Size of the message body buffer, in bytes.

• pbProviderSpecificBuffer
  [out] Buffer to store provider-specific data. Provider-specific data is any data in addition to the message body stored in pbBuffer.

• dwProviderSpecificBufferSize
  [in] Size of the provider-specific buffer, in bytes.

• smsmgnmGetNextMessageFunction
  [in] Function pointer to the SMSManagerGetNextMessageFunction. The Short Message Service (SMS) router implements this function and retrieves the next fragment of a multipart message.

• pdwBytesRead
  [out] Buffer that stores the number of bytes read and stored in pbBuffer.

Return Value

Returns a standard HRESULT error code.

Requirements

See Also

Reference

Short Message Service Provider Functions
Short Message Service Provider Reference
SMSSTOREITEM