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.