IMsgStore：：SetReceiveFolder
適用於：Outlook 2013 |Outlook 2016
建立資料夾作為特定訊息類別之傳入訊息的目的地。
HRESULT SetReceiveFolder(
LPSTR lpszMessageClass,
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
參數
lpszMessageClass
[in]要與新接收資料夾相關聯之訊息類別的指標。 如果 lpszMessageClass 參數設定為 NULL 或空字串， SetReceiveFolder 會 設定訊息存放區的預設接收資料夾。
ulFlags
[in]旗標的位掩碼，控制傳入字串中的文字類型。 您可以設定下列旗標：
MAPI_UNICODE
訊息類別字串是 Unicode 格式。 如果未設定MAPI_UNICODE旗標，訊息類別字串會是 ANSI 格式。
cbEntryID
[in] lpEntryID 參數所指向之專案標識碼中的位元組計數。
lpEntryID
[in]要建立為接收資料夾之資料夾之專案標識碼的指標。 如果 lpEntryID 參數設定為 NULL，SetReceiveFolder 會將目前的接收資料夾取代為訊息存放區的預設值。
傳回值
S_OK
已成功建立接收資料夾。
註解
IMsgStore：：SetReceiveFolder 方法會設定或變更特定訊息類別的接收資料夾。 使用 SetReceiveFolder，用戶端可以使用後續呼叫，為每個定義的訊息類別指定不同的接收資料夾，或指定多個訊息類別的傳入訊息全部移至相同的資料夾。 例如，用戶端可以有自己的訊息類別抵達自己的資料夾。 傳真應用程式可以指定一個存放區提供者放置內送傳真的資料夾，以及提供者放置傳出傳真的另一個資料夾。
如果在呼叫 SetReceiveFolder 期間發生錯誤，接收資料夾設定會保持不變。
如果 SetReceiveFolder 將 lpEntryID 設為 NULL 的接收資料夾設定變更為 NULL，表示應該設定預設的接收資料夾，則 SetReceiveFolder 會傳回S_OK，即使沒有指定之訊息類別的現有設定也一樣。
MFCMAPI 參考
如需 MFCMAPI 範例程式代碼，請參閱下表。
| 檔案 | Function | Comment |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg：：OnSetReceiveFolder |
MFCMAPI 會使用 IMsgStore：：SetReceiveFolder 方法，將資料夾設定為特定訊息類別的接收資料夾。 |