HrEntryIDFromSz

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Recreates an entry identifier from its ASCII encoding.

Header file:	Mapiutil.h
Implemented by:	MAPI
Called by:	Client applications

HRESULT HrEntryIDFromSz(
  LPSTR 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 that contains the new entry identifier.

Return Value

• S_OK
  The recreation was successful.

• MAPI_E_INVALID_ENTRYID
  The entry ID was invalid.

Remarks

The HrEntryIDFromSz and HrSzFromEntryID functions provide conversion between the string and binary formats of entry identifiers.

Notes to Callers

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