Función AssocQueryKeyA (shlwapi.h)

Busca y recupera una clave relacionada con un archivo o una asociación de protocolo del registro.

Sintaxis

LWSTDAPI AssocQueryKeyA(
  [in]  ASSOCF   flags,
  [in]  ASSOCKEY key,
  [in]  LPCSTR   pszAssoc,
  [in]  LPCSTR   pszExtra,
  [out] HKEY     *phkeyOut
);

Parámetros

[in] flags

Tipo: ASSOCF

Marcas que se pueden usar para controlar la búsqueda. Puede ser cualquier combinación de valores de ASSOCF, excepto que solo se puede incluir un valor ASSOCF_INIT.

[in] key

Tipo: ASSOCKEY

El asSOCKEY valor que especifica el tipo de clave que se va a devolver.

[in] pszAssoc

Tipo: LPCTSTR de

Puntero a una cadena terminada en null que se usa para determinar la clave raíz. Se pueden usar cuatro tipos de cadenas.

Extensión de nombre de archivo

Extensión de nombre de archivo, como .txt.

CLSID

UN GUID CLSID en el formato "{GUID}" estándar.

ProgID

ProgID de una aplicación, como Word.Document.8.

Nombre del archivo ejecutable

Nombre del archivo .exe de una aplicación. La marca ASSOCF_OPEN_BYEXENAME debe establecerse en marcas.

[in] pszExtra

Tipo: LPCTSTR de

Puntero a una cadena opcional terminada en NULL con información adicional sobre la ubicación de la cadena. Normalmente se establece en un verbo shell, como abrir. Establezca este parámetro en NULL si no se usa.

[out] phkeyOut

Tipo: HKEY*

Puntero al valor HKEY de la clave.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error COM de lo contrario.

Observaciones

Esta función es un contenedor para la interfaz IQueryAssociations. Está pensado para simplificar el proceso de uso de la interfaz . Para obtener más información sobre cómo funcionan las funciones de asociación de archivos y protocolos, consulte IQueryAssociations.

Nota

El encabezado shlwapi.h define AssocQueryKey como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 5.0 o posterior)