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

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.

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

Confira também

Programas padrão

IApplicationAssociationRegistration