IMAPISession::PrepareForm
适用于：Outlook 2013 | Outlook 2016
创建 IMAPISession：：ShowForm 方法用于访问消息的数字令牌。
HRESULT PrepareForm(
LPCIID lpInterface,
LPMESSAGE lpMessage,
ULONG FAR * lpulMessageToken
);
参数
lpInterface
[in]指向接口标识符的指针 (IID) ，表示用于访问消息的接口。 传递 null 会导致使用标准接口或 IMessage。 lpInterface 参数必须为 null 或IID_IMessage。
lpMessage
[in]指向要显示在窗体中的消息的指针。
lpulMessageToken
[out]指向消息令牌的指针， IMAPISession：：ShowForm 方法使用该令牌访问 lpMessage 指向的消息。
返回值
S_OK
表单准备成功。
备注
IMAPISession：:P repareForm 方法为 lpMessage 参数指向的消息创建消息令牌，并调用消息的 IUnknown：：AddRef 方法。 此令牌在 ulMessageToken 参数中传递给 IMAPISession：：ShowForm。
给调用方的说明
如果对 PrepareForm 的调用成功，请在调用 ShowForm 之前通过调用其 IUnknown：：Release 方法释放 lpMessage 指向的消息。 在调用 ShowForm 之前未能释放消息可能会导致内存泄漏。
MFCMAPI 引用
有关 MFCMAPI 示例代码，请参阅下表。
| 文件 | 函数 | Comment |
|---|---|---|
| MAPIFormFunctions.cpp |
OpenMessageModal |
MFCMAPI 使用 IMAPISession：:P repareForm 方法以及 IMAPISession：：ShowForm 以模式形式显示消息。 |