HrEntryIDFromSz

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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.