Interface IQueryAssociations (shlwapi.h)

Expõe métodos que simplificam o processo de recuperação de informações armazenadas no registro em associação com a definição de um tipo de arquivo ou protocolo e a associação a um aplicativo.

Herança

A interface IQueryAssociations herda da interface IUnknown . IQueryAssociations também tem esses tipos de membros:

Métodos

A interface IQueryAssociations tem esses métodos.

IQueryAssociations::GetData Pesquisa e recupera dados binários relacionados à associação de arquivo ou protocolo do registro.
IQueryAssociations::GetEnum Este método não está implementado. (IQueryAssociations.GetEnum)
IQueryAssociations::GetKey Pesquisa e recupera uma chave relacionada à associação de arquivo ou protocolo do registro.
IQueryAssociations::GetString Pesquisa e recupera uma cadeia de caracteres relacionada à associação de arquivo ou protocolo do registro. (IQueryAssociations.GetString)
IQueryAssociations::Init Inicializa a interface IQueryAssociations e define a chave raiz para o ProgID apropriado.

Comentários

Quando implementar

Essa interface é exposta pelo Shell ou por extensões de namespace para simplificar o tratamento de associações de arquivo e protocolo. Você não deve implementar essa interface.

Quando usar

Use essa interface se precisar de informações do registro relacionadas a associações de arquivo ou protocolo. Por exemplo, você pode usar essa interface para recuperar informações associadas a uma extensão de nome de arquivo, como a cadeia de caracteres de comando de um de seus verbos.

Um caminho completo do registro ou valor HKEY não é necessário. Em vez disso, você pode recuperar informações com base em critérios como a extensão de nome de arquivo ou o nome executável. Para obter uma discussão sobre associações de arquivos, consulte Tipos de arquivo.

Você também pode recuperar o nome de um aplicativo usando essa interface. Use o método IQueryAssociations::GetString. Defina o parâmetro str como ASSOCSTR_FRIENDLYAPPNAME.

Para usar essa interface, primeiro você deve recuperar um ponteiro para ela. Normalmente, você recupera um ponteiro QueryInterface chamando o método IShellFolder::GetUIObjectOf de um objeto Shell. Você também pode recuperar um ponteiro de interface chamando AssocCreate (defina clsid como CLSID_QueryAssociations). Inicialize a interface com IQueryAssociations::Init. Esse método define a chave raiz que será usada quando você chamar qualquer um dos três métodos restantes para recuperar informações do Registro. Eles ficarão apenas abaixo da chave raiz. Você deve liberar a interface quando não precisar mais dela.

A interface IQueryAssociations será útil se você precisar consultar repetidamente o Registro para obter informações. Depois que a interface é inicializada, a sobrecarga de chamar os vários métodos é relativamente pequena. Também há várias funções relacionadas, listadas na seção Ver Também, que permitem recuperar as mesmas informações do Registro com uma única chamada de função. Embora sejam mais simples de usar, eles causam a sobrecarga de criar e inicializar IQueryAssociations sempre que são chamados. Por isso, eles são mais adequados para uso único.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h

Confira também

AssocQueryKey

AssocQueryString

AssocQueryStringByKey