Función AssocQueryStringByKeyA (shlwapi.h)

Busca y recupera una cadena relacionada con la asociación de archivos del Registro a partir de una clave especificada.

Sintaxis

LWSTDAPI AssocQueryStringByKeyA(
  [in]            ASSOCF   flags,
  [in]            ASSOCSTR str,
  [in]            HKEY     hkAssoc,
  [in, optional]  LPCSTR   pszExtra,
  [out, optional] LPSTR    pszOut,
  [in, out]       DWORD    *pcchOut
);

Parámetros

[in] flags

Tipo: ASSOCF

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

[in] str

Tipo: ASSOCSTR

Valor ASSOCSTR que especifica el tipo de cadena que se va a devolver.

[in] hkAssoc

Tipo: HKEY

Valor HKEY de la clave que se usará como clave raíz. La búsqueda solo se ve debajo de esta clave.

[in, optional] pszExtra

Tipo: LPCTSTR

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 abierto. Establezca este parámetro en NULL si no se usa.

[out, optional] pszOut

Tipo: LPTSTR

Puntero a una cadena terminada en null utilizada para devolver la cadena solicitada. Establezca este parámetro en NULL para recuperar el tamaño de búfer necesario.

[in, out] pcchOut

Tipo: DWORD*

Puntero a un valor que, en la entrada, especifica el número de caracteres en el búfer pszOut . Cuando la función devuelve, apunta al número de caracteres colocados en el búfer.

Si la marca ASSOCF_NOTRUNCATE se establece en marcas y el búfer especificado en pszOut es demasiado pequeño, la función devuelve E_POINTER y el valor se establece en el tamaño necesario del búfer.

Si pszOut es NULL, la función devuelve S_FALSE y pcchOut apunta al tamaño necesario del búfer.

Valor devuelto

Tipo: HRESULT

Devuelve un valor de error COM estándar, incluido lo siguiente:

Error	Significado
S_OK	Correcto.
E_POINTER	El búfer pszOut es demasiado pequeño para contener toda la cadena.
S_FALSE	pszOut es NULL. pcchOut contiene el tamaño de búfer necesario.

Comentarios

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

Nota

El encabezado shlwapi.h define AssocQueryStringByKey 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlwapi.h
Library	Shlwapi.lib
Archivo DLL	Shlwapi.dll (versión 5.0 o posterior)