The HrEntryIDFromSz function recreates an entry identifier from its ASCII encoding.
Note This function may not be supported in future versions of MAPI.
Header file: | MAPIUTIL.H |
Implemented by: | MAPI |
Called by: | Client applications |
HRESULT HrEntryIDFromSz(
LPTSTR sz,
ULONG FAR * pcb,
LPENTRYID FAR * ppentry
);
The HrEntryIDFromSz and HrSzFromEntryID functions provide conversion between the string and binary formats of entry identifiers. Simple MAPI uses ASCII strings for message identifiers, while MAPI uses structures with binary data.
A client application using Simple MAPI for most message operations may need to resort to MAPI in some cases. The only folder recognized by Simple MAPI is the Inbox, and if the client needs to access messages in another folder, it must use MAPI methods to look through that folder's contents table, which holds message entry identifiers.
The HrEntryIDFromSz function allocates memory for the ASCII string using the MAPIAllocateBuffer function.