Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function is used to determine an upper boundary for the size of the buffer that must be provided to SmsReadMessagewhen the next message is read.

Syntax

HRESULT SmsGetMessageSize (
  const SMS_HANDLE  
smshHandle,
  DWORD* const
pdwDataSize
);

Parameters

smshHandle

A Short Message Service (SMS) handle obtained from calling SmsOpen.

pdwDataSize

Size (in bytes) of the buffer to allocate.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK

The method completed successfully.

For information about additional return values, see SMS Specific Errorsand SMS General Errors.

Remarks

For efficiency reasons, SmsGetMessageSizemay not return a value that exactly matches the size of the message. However, you are guaranteed to get a value that is at least large enough to hold the entire message.

You can also use IMailRuleClientto read SMS messages.

Requirements

Header sms.h
Library sms.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also