ChooseContact

9/8/2008

The ChooseContact função inicia o controle Contact Chooser, que fornece acessar para a interface aplicativo contato para selecionar contatos no seu aplicativo.

Syntax

HRESULT ChooseContact(
   LPCHOOSECONTACT lpcc
);

Parameters

• lpcc
  [In/Out] Referência a uma estrutura CHOOSECONTACT. Ele contém informações usadas para inicializar o controle Contact Chooser e informações de retorno sobre contato e propriedade seleção do usuário. Consulte CHOOSECONTACT Structure para obter mais detalhes.

Return Value

This method returns the standard values HRESULT_FROM_WIN32(GetLastError()), E_INVALIDARG GPSGetPosition, e S_FAIL, as well as o seguinte.

• S_OK
  O método foi concluída com êxito e o controle Contact Chooser foi iniciado com êxito.

  A reserva apontado pelo oidContactID membro da estrutura CHOOSECONTACT Structure contém o OID do contato, o ContactName membro contém o nome do contato selecionado, o pridPropertyID membro contém o nome da propriedade selecionada e o lpstrPropertyValue membro contém a valor da seqüência de caracteres dos dados na propriedade selecionada.

• S_FALSE
  O controle Contact Chooser exibido com êxito, e propidSelected Foi definido, mas não havia memória suficiente alocar bstrPropertyValueSelected e MapVirtualKey. bstrContactName. Isso sugere que o usuário escolheu um contato, mas não informações foi escritas para o bstrPropertyValueSelected e MapVirtualKey. bstrContactName Propriedades.

• E_ABORT
  O usuário cancelou out of o controle Contact Chooser.

• E_INVALIDARG
  Um inválido argumento passado para a função ChooseContact.

Remarks

O controle Contact Chooser é um restrito System-defined caixa diálogo. Ele fornece a interface usuário que permite que os usuários selecionem um único contato e uma única propriedade desse contato. Ele é usado pelo aplicativo do sistema de mensagens para selecionar destinatários email, pelo calendário para selecionar os participantes da reunião e pelo aplicativo de imagens para associar uma imagem com um contato.

O cliente está bloqueada enquanto este diálogo estiver visível.

Você deve ter RequiredProperties Definir como escolher uma propriedade.

SelectContact deve conter um válido contato item quando ChoosePropertyOnly é TRUE.

Configuração ChooseContactOnly Para TRUE define automaticamente ChoosePropertyOnly para FALSE.

Por padrão, ChooseContactOnly é definido como TRUE. Isso permite que você chamar ShowDialog Sem configuração quaisquer propriedades e ainda get um comportamento usar como padrão razoável.

ChooseContact Falha ao CCF_CHOOSECONTACTONLY é FALSE e rgpropidRequiredProperties é NULL.

Exemplo de código

O seguinte exemplo de código demonstra como usar ChooseContact.

Observação

Para tornar o exemplo de código mais fácil para ler, verificação de segurança e manipulação de erro não estão incluídos.This code example should not be used in a release configuration unless it has been modified to include them.

HRESULT ContactChooserExample()
{
    HRESULT hr                      = E_FAIL;    
    const CEPROPID c_propidAllEmail = PIMPR_ALL_EMAIL; 
    CHOOSECONTACT cc                = {0};

    // Setup the CHOOSECONTACT structure.
    cc.cbSize                     = sizeof (cc);
    cc.dwFlags                    = CCF_RETURNCONTACTNAME | CCF_RETURNPROPERTYVALUE | CCF_HIDENEW;
    cc.rgpropidRequiredProperties = &c_propidAllEmail;

    // The number of properties specified in the c_propidAllEmail array.
    cc.cRequiredProperties = 1;
    cc.hwndOwner           = NULL;

    // Display the Contact Chooser control, and prompt the user to choose a Contact.
    hr = ChooseContact(&cc);

    // The name, and a string representation of the property, is returned according to the flags set in the CHOOSECONTACT structure above.
    DEBUGMSG(TRUE, (L"%s's email address is %s", cc.bstrContactName, cc.bstrPropertyValueSelected));

    // Free memory.
    SysFreeString(cc.bstrContactName);
    SysFreeString(cc.bstrPropertyValueSelected);

    return hr;
}

Requirements

Header	pimstore.h
Library	Pimstore.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

Pocket Outlook Object Model Functions
CHOOSECONTACT Structure
Contact Chooser Flags