Compartilhar via

HrGetAutoDiscoverXML

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

Retorna um fluxo XML (Linguagem de Marcação Extensível) que representa informações recuperadas do serviço de descoberta automática de um servidor do Microsoft Exchange 2007.

Informações rápidas

Propriedade Valor
Exportado por:
 olmapi32.dll
Chamado por:
 Cliente
Implementado por:
 Outlook
 
HRESULT HrGetAutoDiscoverXML( 
    __in_z const WCHAR *pwzAddress, 
    __in_opt_z const WCHAR *pwzPassword, 
    __in_opt HANDLE hCancelEvent, 
    __in_opt ULONG ulFlags, 
    __out IStream** ppXmlStream);

Parâmetros

pwzAddress

[in] Um endereço de email SMTP (Protocolo de Transferência de Email Simples) encerrado nulo da conta para a qual você deseja recuperar as informações de descoberta automática.

pwzPassword

[in] Uma senha opcional para a conta especificada por pwzAddress. Observe que passar qualquer senha não terá efeito se a conta especificada por pwzAddress não exigir uma senha.

hCancelEvent

[in] Um identificador de evento Win32 não configurado que é opcional e pode ser usado para cancelar a operação. Para cancelar a operação, defina o evento e passe o identificador de evento como hCancelEvent; passe nulo se você não quiser cancelar a operação. Observe que passar um valor que não representa um identificador de evento não tem efeito e é ignorado pela função.

ulFlags

[in] Este parâmetro não é usado. Deve ser 0.

ppXmlStream

[out] Um ponteiro para um objeto IStream que contém o XML de descoberta automática. Retornará nulo se a operação de descoberta automática falhar. Você deve liberar o objeto IStream quando terminar com ele.

Valores de retorno

S_OK

  • A chamada de função é bem-sucedida.

E_INVALIDARG

  • pwzAddress é nulo ou não é um endereço SMTP válido ou ppXmlStream é um ponteiro nulo para um objeto IStream .

MAPI_E_NOT_FOUND

  • O computador cliente não está conectado à rede, o computador cliente não está conectado a um servidor do Microsoft Exchange 2007, pwzAddress não é uma conta em um servidor exchange 2007 ou pwzAddress é uma conta que não dá suporte ao serviço de descoberta automática do Exchange.

MAPI_E_USER_CANCEL

  • Um identificador de evento foi passado para hCancelEvent para cancelar a operação.

STRSAFE_E_INSUFFICIENT_BUFFER

  • O valor passado para pwzAddress ou pwzPassword é muito longo, de modo que ultrapassa o buffer interno do tamanho 256 bytes.