HrEntryIDFromSz

The HrEntryIDFromSz function recreates an entry identifier from its ASCII encoding.

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

HRESULT HrEntryIDFromSz(
  LPTSTR sz,               
  ULONG FAR * pcb,         
  LPENTRYID FAR * ppentry  
);

Parameters

sz: [in] Pointer to the ASCII string from which to create an entry identifier.
pcb: [out] Pointer to the size, in bytes, of the entry identifier pointed to by the ppentry parameter.
ppentry: [out] Pointer to a pointer to the returned ENTRYID structure containing the new entry identifier.

Remarks

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.

Notes to Callers

The HrEntryIDFromSz function allocates memory for the ASCII string using the MAPIAllocateBuffer function.