IProfSect：IMAPIProp
適用於：Outlook 2013 |Outlook 2016
使用配置檔區段對象的屬性。
| 屬性 | 值 |
|---|---|
| 標頭檔： |
Mapix.h |
| 公開者： |
配置檔區段物件 |
| 實作者： |
Mapi |
| 通話者： |
用戶端應用程式和服務提供者 |
| 介面識別碼： |
IID_IProfSect |
| 指標類型： |
LPPROFSECT |
| 交易模型： |
非交易式 |
Vtable 順序
這個介面沒有任何唯一的方法。
| 必要屬性 | Access |
|---|---|
|
PR_OBJECT_TYPE (PidTagObjectType) |
唯讀 |
|
PR_PROFILE_NAME (PidTagProfileName) |
唯讀 |
呼叫者注意事項
IProfSect 介面本身沒有任何唯一的方法，但您可以呼叫配置檔區段的 IMAPIProp 方法。 IProfSect 實作和其他 IMAPIProp 實作之間有一些差異：
IProfSect 不支援交易模型。
IProfSect 不支援具名屬性。
IProfSect 會保留標識符範圍0x67F0 0x67ff安全屬性。
不支援交易模型表示在呼叫 IMAPIProp：：CopyProps 和 IMAPIProp：：CopyTo 方法之後，對配置檔區段所做的所有變更都會立即發生。 對 IMAPIProp：：SaveChanges 方法的 呼叫成功，但不會實際儲存任何變更。
若要防止提前發生的變更，服務提供者必須製作其配置檔區段的複本，這些區段會透過屬性表向用戶顯示。 屬性表應該與複本搭配使用，而不是實際配置檔區段。 當使用者按兩下 [ 確定 ] 按鈕來確認變更正確時，變更可以儲存到實際的配置檔區段。
若要使用複製的設定檔區段實作屬性表，請使用下列程式：
呼叫 IMAPISupport：：OpenProfileSection 或 IProviderAdmin：：OpenProfileSection 方法來開啟配置檔區段。
呼叫 CreateIProp 函式 來擷取屬性資料物件， 這是支援 IPropData 介面的物件。
呼叫配置檔區段的 IMAPIProp：：CopyTo 方法，將出現在屬性表上的屬性從配置檔區段複製到屬性資料物件。
呼叫 IMAPISupport：:D oConfigPropSheet 方法，要求服務提供者顯示屬性表，並在 lpConfigData 參數中傳遞屬性數據物件的指標。
當使用者將變更儲存到屬性表中的組態屬性時，請呼叫 IMAPIProp：：CopyTo 方法，將屬性資料物件中的屬性複製回設定檔區段。
與其他物件不同的配置檔區段不支援具名屬性。 如果在配置檔區段物件上呼叫 IMAPIProp：：GetIDsFromNames 和 IMAPIProp：：GetNamesFromIDs 方法，則會傳回MAPI_E_NO_SUPPORT。 如果您使用 IMAPIProp：：SetProps 方法在上述範圍中設定屬性標識碼0x8000，則會傳回PT_ERROR屬性類型。
配置檔區段會保留標識元範圍，0x67F0 0x67FF安全屬性。 服務提供者可以使用此範圍來儲存密碼和其他提供者特定的認證。 在 IMAPIProp：：GetProps 方法的 lpPropTag 參數中傳遞 NULL 時，不會在屬性的完整清單中傳回此範圍中的屬性，也不會在 IMAPIProp：：GetPropList 方法的 lppPropTagArray 參數中傳回這些屬性。 安全屬性必須特別由其標識碼要求。
MAPI 會以硬式編碼常數MUID_PROFILE_INSTANCE做為標識符，並 PR_SEARCH_KEY (PidTagSearchKey) 做為其單一屬性的配置檔區段。 MAPI 可確保 PR_SEARCH_KEY 屬性值在所有建立的配置檔中都是唯一的。 當唯一性很重要時，請使用 PR_SEARCH_KEY 而非 PR_PROFILE_NAME ，因為刪除的配置檔後面可能會有另一個具有相同名稱的配置檔。
如需如何使用配置檔區段的詳細資訊，請參閱 管理配置檔和訊息服務。