Compartilhar via

Método IApplicationAssociationRegistration::QueryCurrentDefault (shobjidl_core.h)

  • Artigo

Determina o aplicativo padrão para um determinado tipo de associação. Esse é o aplicativo padrão iniciado por ShellExecute para esse tipo.

Sintaxe

HRESULT QueryCurrentDefault(
  [in]  LPCWSTR          pszQuery,
  [in]  ASSOCIATIONTYPE  atQueryType,
  [in]  ASSOCIATIONLEVEL alQueryLevel,
  [out] LPWSTR           *ppszAssociation
);

Parâmetros

[in] pszQuery

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém a extensão ou protocolo de nome de arquivo, como .mp3 ou http.

[in] atQueryType

Tipo: ASSOCIATIONTYPE

Um dos valores de enumeração ASSOCIATIONTYPE que especifica o tipo de associação, como extensão ou tipo MIME.

[in] alQueryLevel

Tipo: ASSOCIATIONLEVEL

Um dos valores de enumeração ASSOCIATIONLEVEL que especifica o nível de associação, como por usuário ou computador. Normalmente, isso é AL_EFFECTIVE.

[out] ppszAssociation

Tipo: LPWSTR*

Quando esse método retorna, contém o endereço de um ponteiro para o ProgID que identifica a associação padrão atual.

Nota É responsabilidade do aplicativo de chamada liberar a cadeia de caracteres por meio de CoTaskMemFree.
 

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A cadeia de caracteres produzida normalmente é um ProgID correspondente a um dos ProgIDs associados a um aplicativo registrado, mas há algumas exceções: se a cadeia de caracteres retornada for um protocolo padrão de computador, será uma cadeia de caracteres herdada que indica uma linha de comando para um manipulador de .exe em vez de um ProgID. Da mesma forma, se retornar um tipo MIME padrão do computador, ele retornará uma cadeia de caracteres CLSID (identificador de classe herdada) em vez de um ProgID.

Requisitos

Requisito Valor
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)

Confira também

Programas padrão

IApplicationAssociationRegistration