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

Inicializa a interface IQueryAssociations e define a chave raiz para o ProgID apropriado.

Sintaxe

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

Parâmetros

[in] flags

Tipo: ASSOCF

Um sinalizador que especifica como a pesquisa deve ser inicializada. Normalmente, ele é definido como zero, mas também pode usar um dos seguintes valores ASSOCF .

• ASSOCF_INIT_BYEXENAME
• ASSOCF_INIT_DEFAULTTOFOLDER
• ASSOCF_INIT_DEFAULTTOSTAR

[in, optional] pszAssoc

Tipo: LPCWSTR

Uma cadeia de caracteres Unicode usada para determinar a chave raiz. Se um valor for especificado para hkProgid, defina esse parâmetro como NULL. Quatro tipos de cadeia de caracteres podem ser usados:

Extensão de nome de arquivo

Uma extensão de nome de arquivo, como .txt.

CLSID

Um GUID CLSID no formato padrão "{GUID}".

ProgID

ProgID de um aplicativo, como Word.Document.8.

Nome executável

O nome do arquivo de .exe de um aplicativo. O sinalizador ASSOCF_OPEN_BYEXENAME deve ser definido em sinalizadores.

[in, optional] hkProgid

Tipo: HKEY

O valor HKEY da subchave que é usada como uma chave raiz. A pesquisa só fica abaixo dessa chave. Se um valor for especificado para pwszAssoc, defina esse parâmetro como NULL.

[in, optional] hwnd

Tipo: HWND

Valor de retorno

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

Esse método inicializa a interface e também é chamado sempre que você precisa especificar uma nova chave raiz. Você pode usar pwszAssoc para especificar uma cadeia de caracteres, como uma extensão de nome de arquivo ou sua ProgID associada, que identifica a chave raiz. Você também pode especificar o valor HKEY da chave raiz. Em seguida, o Init usará essas informações para localizar a chave raiz no Registro. As chamadas subsequentes para os outros métodos IQueryAssociations o usarão como ponto de partida e procurarão as informações nas subchaves da chave raiz.

Requirements

Consulte também

IQueryAssociations