IMAPISupport::CopyMessages
適用於:Outlook 2013 |Outlook 2016
將訊息從一個資料夾複製或移動到另一個資料夾。
HRESULT CopyMessages(
LPCIID lpSrcInterface,
LPVOID lpSrcFolder,
LPENTRYLIST lpMsgList,
LPCIID lpDestInterface,
LPVOID lpDestFolder,
ULONG_PTR ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
參數
lpSrcInterface
[in]介面識別碼的指標 (IID) ,表示用來存取包含要複製或移動之訊息之資料夾的介面。
lpSrcFolder
[in]資料夾的指標,其中包含要複製或移動的訊息。
lpMsgList
[in]項目標識子陣列的指標,識別要複製或行動的訊息。
lpDestInterface
[in]介面識別碼的指標 (IID) ,表示要用來存取所複製或移動訊息之目的地資料夾的介面。
lpDestFolder
[in]複製或移動之訊息之目的地資料夾的指標。 此資料夾必須開啟。
ulUIParam
[in]顯示進度指標之進度物件的指標。 如果在 lpProgress 中傳遞 NULL,訊息存放區提供者會使用 MAPI 進度物件實作來顯示進度指示器。 除非在ulFlags中設定MESSAGE_DIALOG旗標,否則會忽略 lpProgress 參數。
lpProgress
[in]顯示進度指標之進度物件的指標。 如果在 lpProgress 中傳遞 NULL,訊息存放區提供者會使用 MAPI 進度物件實作來顯示進度指示器。 除非在ulFlags中設定MESSAGE_DIALOG旗標,否則會忽略 lpProgress 參數。
ulFlags
[in]控制複製或移動作業完成方式的旗標位掩碼。 您可以設定下列旗標:
MESSAGE_DIALOG
要求顯示進度指示器。
MESSAGE_MOVE
訊息應該移動,而不是複製。 如果未設定MESSAGE_MOVE,則會複製訊息。
傳回值
S_OK
複製或移動作業成功。
MAPI_E_USER_CANCEL
使用者已取消作業,通常是按兩下對話框中的 [ 取消 ] 按鈕。
註解
針對訊息存放區提供者支援對象實作 IMAPISupport::CopyMessages 方法。 訊息存放區提供者可以在實作 IMAPIFolder::CopyMessages 時呼叫 IMAPISupport::CopyMessages,將一或多個訊息從一個文件夾複製或移動到另一個資料夾。 在 IMAPISupport::CopyMessages 呼叫中,訊息存放區提供者可以指定 MAPI 應該顯示進度指示器。