Método IQueryAssociations::Init (shlwapi.h)

  • Artículo

Inicializa la interfaz IQueryAssociations y establece la clave raíz en el ProgID adecuado.

Sintaxis

HRESULT Init(
  [in]           ASSOCF  flags,
  [in, optional] LPCWSTR pszAssoc,
  [in, optional] HKEY    hkProgid,
  [in, optional] HWND    hwnd
);

Parámetros

[in] flags

Tipo: ASSOCF

Marca que especifica cómo se va a inicializar la búsqueda. Normalmente se establece en cero, pero también puede tomar uno de los siguientes valores ASSOCF .

[in, optional] pszAssoc

Tipo: LPCWSTR

Cadena Unicode que se usa para determinar la clave raíz. Si se especifica un valor para hkProgid, establezca este parámetro en NULL. Se pueden usar cuatro tipos de cadena:

Extensión de nombre de archivo

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

CLSID

GUID clSID en el formato estándar "{GUID}".

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, optional] hkProgid

Tipo: HKEY

Valor HKEY de la subclave que se usa como clave raíz. La búsqueda solo se ve debajo de esta clave. Si se especifica un valor para pwszAssoc, establezca este parámetro en NULL.

[in, optional] hwnd

Tipo: HWND

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

Este método inicializa la interfaz y también se llama cada vez que necesita especificar una nueva clave raíz. Puede usar pwszAssoc para especificar una cadena, como una extensión de nombre de archivo o su ProgID asociado, que identifica la clave raíz. También puede especificar el valor HKEY de la clave raíz. A continuación, Init usará esta información para buscar la clave raíz en el Registro. Las llamadas posteriores a los otros métodos IQueryAssociations la usarán como punto de partida y buscarán la información en las subclaves de la clave raíz.

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 Shell32.dll (versión 5.0 o posterior)

Consulte también

IQueryAssociations