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 範例程式代碼,請參閱下表。
檔案 | Function | Comment |
---|---|---|
MainDlg.cpp |
CMainDlg::OnOpenDefaultDir |
MFCMAPI 會使用 GetDefaultDir 方法來取得預設通訊錄容器的標識碼。 |