CreateIProp

適用於：Outlook 2013 |Outlook 2016

建立屬性數據物件，也就是 IPropData 物件。

屬性	值
標頭檔：	Mapiutil.h
實作者：	Mapi
通話者：	用戶端應用程式和服務提供者

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

參數

lpInterface

[in]屬性數據物件之 IID) (介面識別碼的指標。 有效的介面標識碼IID_IMAPIPropData。 在 lpInterface 參數中傳遞 NULL 也會使 lppPropData 參數中傳回的屬性數據物件轉換成屬性資料對象的標準介面。

lpAllocateBuffer

[in] MAPIAllocateBuffer 函式的指標，用來配置記憶體。

lpAllocateMore

[in] MAPIAllocateMore 函式的指標，用來配置額外的記憶體。

lpFreeBuffer

[in] MAPIFreeBuffer 函式的指標，用來釋放記憶體。

lpvReserved

[in]保留;必須是零。

lppPropData

[out]傳回之屬性數據物件的指標。

傳回值

S_OK

呼叫成功，並傳回預期的值。

MAPI_E_INTERFACE_NOT_SUPPORTED

此物件不支援要求的介面。

註解

lpAllocateBuffer、lpAllocateMore 和 lpFreeBuffer 輸入參數分別指向 MAPIAllocateBuffer、MAPIAllocateMore 和 MAPIFreeBuffer 函式。 呼叫 CreateIProp 的用戶端應用程式會將指標傳遞至剛命名的 MAPI 函式;服務提供者會將指標傳遞至其初始化呼叫中收到的這些函式，或透過 呼叫 IMAPISupport：：GetMemAllocRoutines 方法來擷取。