IAddrBook::SetDefaultDir
適用於:Outlook 2013 |Outlook 2016
建立指定的容器作為預設通訊簿容器。
HRESULT SetDefaultDir(
ULONG cbEntryID,
LPENTRYID lpEntryID
);
參數
cbEntryID
[in] lpEntryID 參數所指向之專案標識碼中的位元組計數。
lpEntryID
[in]默認通訊簿容器之專案標識碼的指標。
傳回值
S_OK
已成功設定預設通訊簿容器。
註解
用戶端和服務提供者會呼叫 SetDefaultDir 方法來建立新的預設通訊簿容器。 默認容器是第一次開啟通訊錄時,使用者看到顯示在通訊簿中的容器。 SetDefaultDir 會 將預設容器儲存為配置檔中的專案。 容器會保持預設值,直到在相同會話或另一個會話中對 SetDefaultDir 進行另一個呼叫,或移除容器為止。
注意事項
PR_AB_CHOOSE_DIRECTORY_AUTOMATICALLY屬性會對應至 [通訊錄選項] 對話框中的 [自動選擇] 設定。 當此屬性存在於 [IID_CAPONE_PROF 配置檔] 區段中且設定為 true 時,[通訊簿] 對話方塊不再預設為 SetDefaultDir 所指定的容器,而是選擇 Microsoft Outlook 認為適合顯示對話框的內容的通訊簿。 請注意,這可能會導致第三方通訊簿提供者的體驗不佳。
MFCMAPI 參考
如需 MFCMAPI 範例程式代碼,請參閱下表。
檔案 | Function | Comment |
---|---|---|
Abcontdlg.cpp |
CAbContDlg::OnSetDefaultDir |
MFCMAPI 會使用 SetDefaultDir 方法,將指定的通訊簿容器設為預設通訊簿容器。 |