Edit

HrEntryIDFromSz

  • Article

Applies to: Outlook 2013 | Outlook 2016

Recreates an entry identifier from its ASCII encoding.

Property Value
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.