IAddrBook::SetDefaultDir
Область применения: Outlook 2013 | Outlook 2016
Устанавливает указанный контейнер в качестве контейнера адресной книги по умолчанию.
HRESULT SetDefaultDir(
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Параметры
cbEntryID
[в] Число байтов в идентификаторе записи, на который указывает параметр lpEntryID .
lpEntryID
[в] Указатель на идентификатор записи контейнера адресной книги по умолчанию.
Возвращаемое значение
S_OK
Контейнер адресной книги по умолчанию успешно установлен.
Замечания
Клиенты и поставщики услуг вызывают метод SetDefaultDir , чтобы установить новый контейнер адресной книги по умолчанию. Контейнер по умолчанию — это контейнер, отображаемый пользователем в адресной книге при первом открытии адресной книги. SetDefaultDir сохраняет контейнер по умолчанию в качестве записи в профиле. Контейнер остается по умолчанию до тех пор, пока не будет выполнен другой вызов SetDefaultDir в том же сеансе или в другом сеансе, либо контейнер не будет удален.
Примечание.
Свойство PR_AB_CHOOSE_DIRECTORY_AUTOMATICALLY соответствует параметру Выбрать автоматически в диалоговом окне Параметры адресной книги. Если это свойство существует в разделе профиля IID_CAPONE_PROF и имеет значение true, в диалоговом окне адресной книги по умолчанию больше не используется контейнер, заданный параметром SetDefaultDir, а выбирает адресную книгу, которую Microsoft Outlook считает подходящим для контекста, в котором отображалось диалоговое окно. Обратите внимание, что это может привести к ухудшению работы сторонних поставщиков адресных книг.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| Abcontdlg.cpp |
CAbContDlg::OnSetDefaultDir |
MFCMAPI использует метод SetDefaultDir , чтобы сделать указанный контейнер адресной книги по умолчанию. |