IMAPIFormContainer::ResolveMultipleMessageClasses
適用於:Outlook 2013 |Outlook 2016
將訊息類別群組解析為窗體容器中的表單,並傳回這些表單的表單資訊物件數位。
HRESULT ResolveMultipleMessageClasses(
LPSMESSAGECLASSARRAY pMsgClassArray,
ULONG ulFlags,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
參數
pMsgClassArray
[in]陣列的指標,其中包含要解析的訊息類別名稱。 訊息類別名稱一律是 ANSI 字串,永遠不會是 Unicode。
ulFlags
[in]控制如何解析訊息類別的旗標位掩碼。 您可以設定下列旗標:
MAPIFORM_EXACTMATCH
只應解析完全相符的訊息類別字串。
ppfrminfoarray
[out]表單資訊物件陣列的指標。 如果用戶端應用程式在 pMsgClassArray 參數中傳遞 NULL, 則 ppfrminfoarray 參數會包含容器中所有表單的表單資訊物件。
傳回值
S_OK
呼叫成功,並傳回預期的值。
註解
用戶端應用程式會呼叫 IMAPIFormContainer::ResolveMultipleMessageClasses 方法,將一組訊息類別解析成表單容器內的表單。 ppfrminfoarray 參數中傳回的窗體資訊對象陣列可進一步存取每個窗體的屬性。
呼叫者注意事項
若要將訊息類別群組解析成窗體,請傳入要解析的訊息類別名稱陣列。 若要強制解析完全 (也就是,若要防止解析訊息類別的基類) ,MAPIFORM_EXACTMATCH旗標可以在 ulFlags 參數中傳遞。
如果無法將訊息類別解析為窗體,則會針對窗體資訊陣列中的該訊息類別傳回NULL。 因此,即使方法傳回S_OK,也不會假設所有訊息類別都已成功解析。 請改為檢查傳回陣列中的值。
MFCMAPI 參考
如需 MFCMAPI 範例程式代碼,請參閱下表。
檔案 | Function | Comment |
---|---|---|
FormContainerDlg.cpp |
CFormContainerDlg::OnResolveMultipleMessageClasses |
MFCMAPI 使用 IMAPIFormContainer::ResolveMultipleMessageClasses 方法來尋找與一組訊息類別相關聯的表單。 |