共用方式為


IMessage::GetRecipientTable

適用於:Outlook 2013 |Outlook 2016

傳回郵件的收件者數據表。

HRESULT GetRecipientTable(
  ULONG ulFlags,
  LPMAPITABLE FAR * lppTable
);

參數

ulFlags

[in]控制數據表傳回的旗標位掩碼。 您可以設定下列旗標:

MAPI_DEFERRED_ERRORS

允許 GetRecipientTable 成功傳回,可能在數據表完全可供呼叫的用戶端使用之前。 如果數據表無法使用,則進行後續呼叫可能會導致錯誤。

MAPI_UNICODE

字串資料行應為 Unicode 格式。 如果未設定MAPI_UNICODE旗標,則字串數據行應為 ANSI 格式。

lppTable

[out]收件者數據表指標。

傳回值

S_OK

成功傳回收件者數據表。

註解

IMessage::GetRecipientTable 方法會傳回訊息收件者數據表的指標,其中包含郵件之所有收件者的相關信息。 每個收件者都有一個數據列。

根據是否已提交郵件,收件者數據表會有不同的數據行集。 如需收件者數據表中數據行的完整清單,請參閱 收件者數據表

某些收件者數據表支援各種限制;其他則不會。 支援限制取決於訊息存放區提供者的實作。

ulFlags 參數中設定MAPI_UNICODE旗標會影響下列對收件者數據表的呼叫:

設定 Unicode 旗標會要求從這些呼叫傳回的任何字串資料行資訊為 Unicode 格式。 不過,因為並非所有訊息存放區提供者都支援 Unicode,所以設定此旗標只是要求。

呼叫者注意事項

您可以呼叫 IMessage::ModifyRecipients 方法,在收件者數據表開啟時變更該數據表。 ModifyRecipients 會新增收件者、刪除收件者,或修改收件者屬性。

另請參閱

IMAPIProp::SaveChanges

IMAPITable::QueryRows

IMessage::ModifyRecipients

IMessage:IMAPIProp