Compartir a través de

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

  • Artículo

Determina la aplicación predeterminada para un tipo de asociación determinado. Esta es la aplicación predeterminada iniciada por ShellExecute para ese tipo.

Sintaxis

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

Parámetros

[in] pszQuery

Tipo: LPCWSTR

Puntero a una cadena Unicode terminada en null que contiene la extensión de nombre de archivo o el protocolo, como .mp3 o http.

[in] atQueryType

Tipo: ASSOCIATIONTYPE

Uno de los valores de enumeración ASSOCIATIONTYPE que especifica el tipo de asociación, como el tipo de extensión o MIME.

[in] alQueryLevel

Tipo: ASSOCIATIONLEVEL

Uno de los valores de enumeración ASSOCIATIONLEVEL que especifica el nivel de asociación, como por usuario o máquina. Esto suele ser AL_EFFECTIVE.

[out] ppszAssociation

Tipo: LPWSTR*

Cuando este método finaliza, contiene la dirección de un puntero al ProgID que identifica la asociación predeterminada actual.

Nota Es responsabilidad de la aplicación que realiza la llamada liberar la cadena a través de CoTaskMemFree.
 

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La cadena generada suele ser un ProgID que coincide con uno de los ProgID asociados a una aplicación registrada, pero hay algunas excepciones: si la cadena devuelta es un protocolo predeterminado del equipo, es una cadena heredada que indica una línea de comandos a un controlador de .exe en lugar de un ProgID. De forma similar, si devuelve un tipo MIME predeterminado de la máquina, devuelve una cadena de identificador de clase (CLSID) heredada en lugar de un ProgID.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)

Consulte también

Programas predeterminados

IApplicationAssociationRegistration