IAddrBook::GetDefaultDir
Gilt für: Outlook 2013 | Outlook 2016
Gibt den Eintragsbezeichner für den anfänglichen Adressbuchcontainer zurück.
HRESULT GetDefaultDir(
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
Parameter
lpcbEntryID
[out] Ein Zeiger auf die Byteanzahl im Eintragsbezeichner, auf den der lppEntryID-Parameter verweist.
lppEntryID
[out] Ein Zeiger auf einen Zeiger auf den Eintragsbezeichner des Standardcontainers.
Rückgabewert
S_OK
Der Eintragsbezeichner des Standardcontainers wurde erfolgreich zurückgegeben.
Hinweise
Clientanwendungen und Dienstanbieter rufen die GetDefaultDir-Methode auf, um den Eintragsbezeichner des Standardadressbuchcontainers abzurufen. Der Standardcontainer wird dem Benutzer im Adressbuch angezeigt, wenn das Adressbuch zum ersten Mal geöffnet wird. Wenn kein Standardcontainer durch einen Aufruf der IAddrBook::SetDefaultDir-Methode festgelegt wurde, weist MAPI als Standardcontainer den ersten Container mit Namen zu, die nicht das persönliche Adressbuch (PAB) sind. Wenn ein solcher Container nicht gefunden werden kann, wird der PAB zum Standardcontainer.
Um das Standardverzeichnis festzulegen, ruft ein Client oder Anbieter die SetDefaultDir-Methode auf. Clients und Anbieter müssen die IMAPIProp::SaveChanges-Methode nicht aufrufen. Da Änderungen am Adressbuch nicht durchgeführt werden, werden Änderungen sofort dauerhaft vorgenommen.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnOpenDefaultDir |
MFCMAPI verwendet die GetDefaultDir-Methode , um die ID für den Standardadressbuchcontainer abzurufen. |