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

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

Syntax

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 .

• ASSOCF_INIT_BYEXENAME
• ASSOCF_INIT_DEFAULTTOFOLDER
• ASSOCF_INIT_DEFAULTTOSTAR

[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

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, 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 hrESULT código de error.

Observaciones

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 localizar 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

Consulte también

IQueryAssociations