IMAPIMessageSite：：NewMessage
適用於：Outlook 2013 |Outlook 2016
建立新的訊息。
HRESULT NewMessage(
ULONG fComposeInFolder,
LPMAPIFOLDER pFolderFocus,
LPPERSISTMESSAGE pPersistMessage,
LPMESSAGE FAR * ppMessage,
LPMAPIMESSAGESITE FAR * ppMessageSite,
LPMAPIVIEWCONTEXT FAR * ppViewContext
);
參數
fComposeInFolder
[in]指出訊息應該在哪個資料夾中撰寫。 如果變數為 FALSE， 則會忽略 pFolderFocus 參數，而且窗體查看器可以在任何資料夾中撰寫訊息。 如果變數為 TRUE，而且在 pFolderFocus 參數中傳遞 NULL，則訊息會組成目前的資料夾中。 如果變數為 TRUE，且在 pFolderFocus 中傳遞非 NULL 值，則會在 pFolderFocus 所指向的資料夾中撰寫訊息。
pFolderFocus
[in]建立新訊息之資料夾的指標。
pPersistMessage
[in]新表單之表單物件的指標。
ppMessage
[out]新訊息指標的指標。
ppMessageSite
[out]新訊息之訊息網站對象指標的指標。
ppViewContext
[out]檢視內容的指標，適合傳遞至具有新訊息的新窗體。 如果窗體實作自己的檢視內容，則可在 ppViewContext 參數中傳遞 NULL。
傳回值
S_OK
呼叫成功，並傳回預期的值。
註解
表單物件會呼叫 IMAPIMessageSite：：NewMessage 方法來建立新的訊息。 窗體會使用 NewMessage 從其檢視中取得新的訊息和相關聯的訊息網站。 然後，它可以修改新的訊息。
您也可以在 ppViewContext 參數中傳入非 NULL 值，以取得相關聯的檢視內容。 此檢視內容可以直接使用，也可以匯總並傳遞至新的訊息。 如果需要完整實作，請在 ppViewContext中傳遞 NULL。
如需與表單伺服器相關的介面清單，請參閱 MAPI窗體介面。
MFCMAPI 參考
如需 MFCMAPI 範例程式代碼，請參閱下表。
| 檔案 | Function | Comment |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer：：NewMessage |
MFCMAPI 使用 IMAPIMessageSite：：NewMessage 方法來建立新訊息、具現化新的表單查看器，以及呼叫 SetPersist 在表單查看器上設定訊息。 最後，它會傳回窗體查看器做為訊息網站。 |