IAddrBook::GetDefaultDir
Область применения: Outlook 2013 | Outlook 2016
Возвращает идентификатор записи для исходного контейнера адресной книги.
HRESULT GetDefaultDir(
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
Параметры
lpcbEntryID
[out] Указатель на число байтов в идентификаторе записи, на который указывает параметр lppEntryID .
lppEntryID
[out] Указатель на указатель на идентификатор входа контейнера по умолчанию.
Возвращаемое значение
S_OK
Идентификатор записи контейнера по умолчанию был успешно возвращен.
Замечания
Клиентские приложения и поставщики услуг вызывают метод GetDefaultDir для получения идентификатора записи контейнера адресной книги по умолчанию. Контейнер по умолчанию — это то, что пользователь видит в адресной книге при первом открытии адресной книги. Если контейнер по умолчанию не был задан вызовом метода IAddrBook::SetDefaultDir , MAPI назначает в качестве контейнера по умолчанию первый контейнер с именами, которые не являются личной адресной книгой (PAB). Если такой контейнер не удается найти, paB становится контейнером по умолчанию.
Чтобы задать каталог по умолчанию, клиент или поставщик вызывает метод SetDefaultDir . Клиентам и поставщикам не нужно вызывать метод IMAPIProp::SaveChanges ; Так как изменения в адресной книге не выполняются, изменения немедленно становятся постоянными.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnOpenDefaultDir |
MFCMAPI использует метод GetDefaultDir для получения идентификатора контейнера адресной книги по умолчанию. |