IMAPISession::PrepareForm
Hace referencia a: Outlook 2013 | Outlook 2016
Crea un token numérico que el método IMAPISession::ShowForm usa para acceder a un mensaje.
HRESULT PrepareForm(
LPCIID lpInterface,
LPMESSAGE lpMessage,
ULONG FAR * lpulMessageToken
);
Parameters
lpInterface
[in] Puntero al identificador de interfaz (IID) que representa la interfaz que se va a usar para acceder al mensaje. Si se pasa null , se usa la interfaz estándar, o IMessage. El parámetro lpInterface debe ser null o IID_IMessage.
lpMessage
[in] Puntero al mensaje que se va a mostrar en el formulario.
lpulMessageToken
[out] Puntero a un token de mensaje, que usa el método IMAPISession::ShowForm para acceder al mensaje al que apunta lpMessage.
Valor devuelto
S_OK
La preparación del formulario se realizó correctamente.
Comentarios
El método IMAPISession::P repareForm crea un token de mensaje para el mensaje al que apunta el parámetro lpMessage y llama al método IUnknown::AddRef del mensaje. Este token se pasa en el parámetro ulMessageToken a IMAPISession::ShowForm.
Notas para los llamadores
Si la llamada a PrepareForm se realiza correctamente, libere el mensaje al que apunta lpMessage llamando a su método IUnknown::Release antes de llamar a ShowForm. El error al liberar el mensaje antes de llamar a ShowForm puede provocar pérdidas de memoria.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MAPIFormFunctions.cpp |
OpenMessageModal |
MFCMAPI usa el método IMAPISession::P repareForm , junto con IMAPISession::ShowForm, para mostrar un mensaje en un formulario modal. |