CreateIProp

Gilt für: Outlook 2013 | Outlook 2016

Erstellt ein Eigenschaftsdatenobjekt, d. h. ein IPropData-Objekt.

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

Parameter

lpInterface

[in] Zeiger auf einen Schnittstellenbezeichner (Interface Identifier, IID) für das Eigenschaftsdatenobjekt. Der gültige Schnittstellenbezeichner ist IID_IMAPIPropData. Das Übergeben von NULL im lpInterface-Parameter bewirkt auch, dass das im lppPropData-Parameter zurückgegebene Eigenschaftsdatenobjekt in die Standardschnittstelle für ein Eigenschaftsdatenobjekt umgewandelt wird.

lpAllocateBuffer

[in] Zeiger auf die MAPIAllocateBuffer-Funktion, die zum Zuordnen von Arbeitsspeicher verwendet werden soll.

lpAllocateMore

[in] Zeiger auf die MAPIAllocateMore-Funktion, die zum Zuordnen von zusätzlichem Arbeitsspeicher verwendet werden soll.

lpFreeBuffer

[in] Zeiger auf die MAPIFreeBuffer-Funktion, die zum Freigeben von Arbeitsspeicher verwendet werden soll.

lpvReserved

[in] Reserviert. NULL muss sein.

lppPropData

[out] Zeiger auf einen Zeiger auf das zurückgegebene Eigenschaftsdatenobjekt.

Rückgabewert

S_OK

Der Aufruf erfolgreich ausgeführt und der erwartete Wert oder Werte zurückgegeben hat.

MAPI_E_INTERFACE_NOT_SUPPORTED

Die angeforderte Schnittstelle wird für dieses Objekt nicht unterstützt.

Hinweise

Die lpAllocateBuffer, lpAllocateMoreund lpFreeBuffer-Eingabeparameter zeigen auf die MAPIAllocateBuffer, MAPIAllocateMoreund MAPIFreeBuffer-Funktionen. Eine Clientanwendung, die CreateIProp aufruft, übergibt Zeiger an die MAPI-Funktionen, die gerade benannt wurden. Ein Dienstanbieter übergibt die Zeiger an diese Funktionen, die er in seinem Initialisierungsaufruf empfangen oder mit einem Aufruf der IMAPISupport::GetMemAllocRoutines-Methode abgerufen hat.