HrSzFromEntryID
The HrSzFromEntryID
function encodes an entry identifier into an ASCII string, and allocates memory
for the string.
Note This function
may not be supported in future versions of MAPI.
Quick Info
|
Header file:
|
MAPIUTIL.H |
|
Implemented
by: |
MAPI |
|
Called by: |
Client
applications |
HrSzFromEntryID(
|
ULONG cb, |
|
|
LPENTRYID pentry,
|
|
|
LPTSTR FAR * psz |
|
|
); |
|
Parameters
cb
[in] Size, in
bytes, of the entry identifier pointed to by the pentry parameter.
pentry
[in] Pointer
to an ENTRYID
structure defining the entry identifier to be encoded.
psz
[out] Pointer
to the returned ASCII-encoded string.
Remarks
To use Simple
MAPI to look at messages in a folder other than the Inbox folder, which is the
only folder recognized by Simple MAPI, a client application or service provider
must use MAPI methods. A client or provider calls these methods to enumerate
the messages in the folder by looking through the contents table for the
folder, which stores message entry identifiers. When a client or provider finds
the entry identifier for a particular required message, it can call the HrSzFromEntryID
function to convert the identifier to a string that is a Simple MAPI message
identifier so the message can be manipulated in Simple MAPI. Then the client or
provider can call the Simple MAPI MAPIReadMailFD37C function to retrieve the required
information about the message.
See Also
HrComposeEID, HrEntryIDFromSz