IAddrBook::GetDefaultDir
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna o identificador de entrada do contêiner do catálogo de endereços inicial.
HRESULT GetDefaultDir(
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
Parâmetros
lpcbEntryID
[out] Um ponteiro para a contagem de bytes no identificador de entrada apontado pelo parâmetro lppEntryID .
lppEntryID
[out] Um ponteiro para um ponteiro para o identificador de entrada do contêiner padrão.
Valor de retorno
S_OK
O identificador de entrada do contêiner padrão foi retornado com êxito.
Comentários
Aplicativos cliente e provedores de serviços chamam o método GetDefaultDir para recuperar o identificador de entrada do contêiner do catálogo de endereços padrão. O contêiner padrão é o que o usuário vê exibido no catálogo de endereços quando o catálogo de endereços é aberto pela primeira vez. Se um contêiner padrão não tiver sido definido por uma chamada para o método IAddrBook::SetDefaultDir , o MAPI atribui como contêiner padrão o primeiro contêiner com nomes que não são o PAB (catálogo de endereços pessoal). Se esse contêiner não puder ser encontrado, o PAB se tornará o contêiner padrão.
Para definir o diretório padrão, um cliente ou provedor chama o método SetDefaultDir . Clientes e provedores não precisam chamar o método IMAPIProp::SaveChanges ; como as alterações no catálogo de endereços não são transacionadas, as alterações são imediatamente tornadas permanentes.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnOpenDefaultDir |
O MFCMAPI usa o método GetDefaultDir para obter a ID do contêiner padrão do catálogo de endereços. |