CreateIProp
The CreateIProp
function creates a property data object, that is, an IPropData object.
Quick Info
|
Header
file: |
MAPIUTIL.H |
|
Implemented
by: |
MAPI |
|
Called by: |
Client
applications and service providers |
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.
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 where required.
lpFreeBuffer
[in] Pointer
to the MAPIFreeBuffer
function, to be used to free memory.
lpvReserved
Reserved;
must be zero.
lppPropData
[out] Pointer
to a pointer to the returned property data object.
Return Values
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. If
a client application calls the CreateIProp function, it passes in these
parameters pointers to the functions named as listed. If a service provider
calls CreateIProp, it passes the pointers to these functions it received
in its initialization call or retrieved with a call to the IMAPISupport::GetMemAllocRoutines method.