IAddrBook::SetDefaultDir
Aplica-se a: Outlook 2013 | Outlook 2016
Estabelece o contêiner especificado como o contêiner padrão do catálogo de endereços.
HRESULT SetDefaultDir(
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Parâmetros
cbEntryID
[in] A contagem de bytes no identificador de entrada apontada pelo parâmetro lpEntryID .
Lpentryid
[in] Um ponteiro para o identificador de entrada do contêiner padrão do catálogo de endereços.
Valor de retorno
S_OK
O contêiner do catálogo de endereços padrão foi definido com êxito.
Comentários
Clientes e provedores de serviços chamam o método SetDefaultDir para estabelecer um novo contêiner de catálogo de endereços padrão. O contêiner padrão é o contêiner que o usuário vê exibido no catálogo de endereços quando o catálogo de endereços é aberto pela primeira vez. SetDefaultDir salva o contêiner padrão como uma entrada no perfil. O contêiner permanece como o padrão até que outra chamada para SetDefaultDir seja feita na mesma sessão ou em outra sessão ou o contêiner seja removido.
Observação
A propriedade PR_AB_CHOOSE_DIRECTORY_AUTOMATICALLY corresponde à configuração Escolher automaticamente na caixa de diálogo Opções do Catálogo de Endereços. Quando essa propriedade existe na seção perfil IID_CAPONE_PROF e é definida como true, a caixa de diálogo Catálogo de Endereços não é mais padrão para o contêiner especificado por SetDefaultDir, mas escolhe um catálogo de endereços que o Microsoft Outlook considera apropriado para o contexto em que a caixa de diálogo foi exibida. Observe que isso pode resultar em uma experiência ruim para provedores de catálogo de endereços de terceiros.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| Abcontdlg.cpp |
CAbContDlg::OnSetDefaultDir |
O MFCMAPI usa o método SetDefaultDir para tornar o contêiner do catálogo de endereços especificado o padrão. |