IAddrBook::SetDefaultDir

The IAddrBook::SetDefaultDir method establishes a container as the default address book container — the container that is initially made available.

Quick Info

See IAddrBook : IMAPIProp.

HRESULT SetDefaultDir(
  ULONG cbEntryID,     
  LPENTRYID lpEntryID  
);
 

Parameters

cbEntryID

[in] Count of bytes in the entry identifier pointed to by the lpEntryID parameter.

lpEntryID

[in] Pointer to the entry identifier of the default address book container.

Return Values

S_OK

The default address book container was successfully set.

Remarks

Clients and service providers call the IAddrBook::SetDefaultDir method to establish a new default address book container. The default container is the container that the user sees displayed in the address book when the address book is first opened. SetDefaultDir saves the default container as an entry in the profile. The container remains as the default either until another call to SetDefaultDir is made — in the same session or in another session — or the container is removed.

See Also

IAddrBook::GetDefaultDir, IAddrBook::GetSearchPath, IMAPISession::Logoff, MAPILogonEx