CreateIProp

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.

Creates a property data object, that is, an IPropData object.

SCODE CreateIProp(
  LPCIID lpInterface,
  ALLOCATEBUFFER FAR * lpAllocateBuffer,
  ALLOCATEMORE FAR * lpAllocateMore,
  FREEBUFFER FAR * lpFreeBuffer,
  LPVOID lpvReserved,
  LPPROPDATA FAR * lppPropData
);

Parameters

• lpInterface
  [in] Pointer to an interface identifier (IID) for the property data object. The valid interface identifier is IID_IMAPIPropData. Passing NULL in the lpInterface parameter also causes the property data object returned in the lppPropData parameter to be cast to the standard interface for a property data object.

• lpAllocateBuffer
  [in] Pointer to the MAPIAllocateBuffer function, to be used to allocate memory.

• lpAllocateMore
  [in] Pointer to the MAPIAllocateMore function, to be used to allocate additional memory.

• lpFreeBuffer
  [in] Pointer to the MAPIFreeBuffer function, to be used to free memory.

• lpvReserved
  [in] Reserved; must be zero.

• lppPropData
  [out] Pointer to a pointer to the returned property data object.

Return Value

• S_OK
  The call succeeded and has returned the expected value or values.

• MAPI_E_INTERFACE_NOT_SUPPORTED
  The requested interface is not supported for this object.

Remarks

The lpAllocateBuffer, lpAllocateMore, and lpFreeBuffer input parameters point to the MAPIAllocateBuffer, MAPIAllocateMore, and MAPIFreeBuffer functions, respectively. A client application calling CreateIProp passes in pointers to the MAPI functions just named; a service provider passes the pointers to these functions it received in its initialization call or retrieved with a call to the IMAPISupport::GetMemAllocRoutines method.