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.