SmsGetMessageSize

Send Feedback

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

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

Parameters

  • smshHandle
    An Short Message Service (SMS) handle obtained from calling SmsOpen.
  • pdwDataSize
    Size (in bytes) of the buffer to allocate.

Return Values

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 Errors and SMS General Errors.

Remarks

For efficiency reasons, SmsGetMessageSize may 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 IMailRuleClient to read SMS messages.

Requirements

Smartphone: Smartphone 2002 and later
Pocket PC: Pocket PC 2002 and later
OS Versions: Windows CE 3.0 and later
Header: sms.h
Library: sms.lib

See Also

Short Message Service Functions | SmsReadMessage

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.