Método IAssocHandler::IsRecommended (shobjidl_core.h)

Indica se o aplicativo está registrado como um manipulador recomendado para o tipo de arquivo consultado.

Sintaxe

HRESULT IsRecommended();

Valor retornado

Tipo: HRESULT

Retorna S_OK se o programa for recomendado; caso contrário, S_FALSE.

Comentários

Os aplicativos que se registram como manipuladores para tipos de arquivo específicos podem especificar se são manipuladores recomendados. Isso não tem efeito sobre o comportamento real dos aplicativos quando iniciados. Ele é simplesmente fornecido como uma dica para o usuário e um valor que a interface do usuário pode utilizar programaticamente, se desejado. Por exemplo, a caixa de diálogo Abrir com do Shell separa as entradas em Programas Recomendados e Outros Programas.

Observe que as recomendações do programa podem ser alteradas ao longo do tempo. Um exemplo é fornecido quando o usuário escolhe um aplicativo na caixa de diálogo Abrir com para abrir um tipo de arquivo específico. Isso pode fazer com que o Shell "promova" esse aplicativo para status recomendado para esse tipo de arquivo. Como o status recomendado pode mudar ao longo do tempo, os aplicativos não devem armazenar esse valor em cache, mas consultá-lo sempre que for necessário.

Se SHAssocEnumHandlers tiver sido chamado com o sinalizador ASSOC_FILTER_RECOMMENDED, somente manipuladores recomendados serão retornados. Se o sinalizador ASSOC_FILTER_NONE tiver sido usado, você deverá chamar IAssocHandler::IsRecommended em cada objeto IAssocHandler para determinar se ele é recomendado ou não.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)