共用方式為


MAPI 屬性概觀

適用於:Outlook 2013 |Outlook 2016

屬性是MAPI對象的屬性。 屬性會描述對象的相關內容,例如訊息的主旨行或訊息使用者的地址類型。 MAPI 會定義許多屬性,有些屬性用來描述許多物件,有些則僅適用於特定類型的物件。 用戶端和服務提供者可以藉由建立新的自定義屬性來擴充MAPI的一組預先定義屬性。 用戶端可以定義屬性來描述新的訊息類別,而服務提供者可以定義屬性來公開其訊息系統的獨特功能。

屬性可以是持續性或暫時性的。 從會話到會話保存的屬性可以與其對象的數據或配置檔一起儲存。 暫存屬性只存在於目前會話的持續時間。

用戶端和服務提供者可以使用資料表或屬性表向用戶顯示屬性。 數據表為使用者提供屬於多個物件之某些屬性的唯讀檢視。 數據會以數據列和數據行格式顯示,每個數據列都代表物件,而每個數據行則是屬性。 屬性表是索引標籤式對話框,可顯示單一物件的相關屬性。 屬性表可以提供數據的唯讀或讀取/寫入存取權。 是否允許使用者進行變更,由屬性表的實作者決定。

IMAPIProp 介面是使用屬性的主要介面。 所有支援屬性的物件都會實作 IMAPIPropIMAPIProp 包含擷取屬性值、複製屬性、進行變更及儲存這些變更、屬性名稱與其標識符之間的對應,以及擷取先前錯誤相關信息的方法。

有數個數據結構可用來描述屬性和屬性的相關信息。 最常使用的結構是 SPropValue 結構和 SPropTagArray 結構。 SPropValue 結構包含描述屬性的三個資訊片段:

  • 屬性的數據或值。

  • 屬性值的數據類型,例如整數或布爾值。

  • 特定範圍內的數值,可唯一識別負責維護它的屬性和元件。 例如,有一個範圍可保存MAPI所定義的訊息內容屬性,還有另一個範圍可保存用戶端為自訂訊息類別定義的訊息內容屬性。

屬性類型和標識碼會合併成稱為屬性標記的單一元件。 屬性標記是常數,可用來輕鬆地參考 屬性。 MAPI 所定義屬性的屬性標記會包含在MAPITAGS中。H 頭檔和 SPropValue 結構的 ulPropTag 成員。 用戶端和服務提供者會使用屬性標籤來識別、擷取及更新對應的屬性。

SPropTagArray 結構是屬性標記的計數數位列。 IMAPIProp 和其他介面中的許多方法都會使用 SPropTagArray 結構來描述屬性。

另請參閱

MAPI 概念