Metodo IQueryAssociations::Init (shlwapi.h)

Articolo
03/02/2024

Inizializza l'interfaccia IQueryAssociations e imposta la chiave radice sul ProgID appropriato.

Sintassi

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

Parametri

[in] flags

Tipo: ASSOCF

Flag che specifica la modalità di inizializzazione della ricerca. In genere è impostato su zero, ma può anche accettare uno dei valori ASSOCF seguenti.

[in, optional] pszAssoc

Tipo: LPCWSTR

Stringa Unicode utilizzata per determinare la chiave radice. Se viene specificato un valore per hkProgid, impostare questo parametro su NULL. È possibile usare quattro tipi di stringa:

Estensione del file

Estensione del nome file, ad esempio .txt.

CLSID

GUID CLSID nel formato standard "{GUID}".

ProgID

ProgID di un'applicazione, ad esempio Word. Documento.8.

Nome eseguibile

Nome del file di .exe di un'applicazione. Il flag ASSOCF_OPEN_BYEXENAME deve essere impostato nei flag.

[in, optional] hkProgid

Tipo: HKEY

Valore HKEY della sottochiave utilizzata come chiave radice. La ricerca appare solo sotto questa chiave. Se viene specificato un valore per pwszAssoc, impostare questo parametro su NULL.

[in, optional] hwnd

Tipo: HWND

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo inizializza l'interfaccia e viene chiamato anche ogni volta che è necessario specificare una nuova chiave radice. È possibile usare pwszAssoc per specificare una stringa, ad esempio un'estensione di file o il progID associato, che identifica la chiave radice. È anche possibile specificare il valore HKEY della chiave radice. Init userà quindi queste informazioni per individuare la chiave radice nel Registro di sistema. Le chiamate successive agli altri metodi IQueryAssociations lo useranno come punto di partenza e cercheranno le informazioni nelle sottochiavi della chiave radice.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shell32.dll (versione 5.0 o successiva)

Vedi anche

IQueryAssociations

Condividi tramite