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

  • Artigo

Inicializa a interface IQueryAssociations e define a chave raiz como 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 .

[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 do executável

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

[in, optional] hkProgid

Tipo: HKEY

O valor HKEY da subchave 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

Digite: HWND

Retornar valor

Tipo: HRESULT

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

Comentários

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 seu ProgID associado, 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. 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlwapi.h
Biblioteca Shlwapi.lib
DLL Shell32.dll (versão 5.0 ou posterior)

Confira também

IQueryAssociations