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

  • Artigo

Determina se um aplicativo possui a associação padrão registrada para um determinado nível e tipo de aplicativo. Não se destina ao uso em Windows 8.

Sintaxe

HRESULT QueryAppIsDefault(
  [in]  LPCWSTR          pszQuery,
  [in]  ASSOCIATIONTYPE  atQueryType,
  [in]  ASSOCIATIONLEVEL alQueryLevel,
  [in]  LPCWSTR          pszAppRegistryName,
  [out] BOOL             *pfDefault
);

Parâmetros

[in] pszQuery

Tipo: LPCWSTR

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

[in] atQueryType

Tipo: ASSOCIATIONTYPE

Um dos valores de enumeração ASSOCIATIONTYPE que especifica o tipo do aplicativo chamado em pszQuery, como extensão de nome de arquivo 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.

[in] pszAppRegistryName

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome registrado do aplicativo.

[out] pfDefault

Tipo: BOOL*

Quando esse método retorna, contém TRUE se o aplicativo for o padrão; ou FALSE caso contrário.

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.

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