Interfaccia IQueryAssociations (shlwapi.h)

Espone i metodi che semplificano il processo di recupero delle informazioni archiviate nel Registro di sistema in associazione alla definizione di un tipo di file o di un protocollo e all'associazione a un'applicazione.

Ereditarietà

L'interfaccia IQueryAssociations eredita dall'interfaccia IUnknown . IQueryAssociations include anche questi tipi di membri:

Metodi

L'interfaccia IQueryAssociations include questi metodi.

IQueryAssociations::GetData Cerca e recupera i dati binari correlati all'associazione di file o protocolli dal Registro di sistema.
IQueryAssociations::GetEnum Questo metodo non è implementato. (IQueryAssociations.GetEnum)
IQueryAssociations::GetKey Cerca e recupera una chiave correlata all'associazione di file o protocolli dal Registro di sistema.
IQueryAssociations::GetString Cerca e recupera una stringa correlata all'associazione di file o protocollo dal Registro di sistema. (IQueryAssociations.GetString)
IQueryAssociations::Init Inizializza l'interfaccia IQueryAssociations e imposta la chiave radice sul ProgID appropriato.

Commenti

Quando implementare

Questa interfaccia viene esposta dalla shell o dalle estensioni dello spazio dei nomi per semplificare la gestione delle associazioni di file e protocolli. Non è consigliabile implementare questa interfaccia.

Quando usare

Usare questa interfaccia se sono necessarie informazioni dal Registro di sistema correlate alle associazioni di file o protocolli. Ad esempio, è possibile usare questa interfaccia per recuperare informazioni associate a un'estensione di file, ad esempio la stringa di comando di uno dei relativi verbi.

Non è necessario un percorso completo del Registro di sistema o un valore HKEY. È invece possibile recuperare informazioni in base a criteri quali l'estensione del file o il nome eseguibile. Per una descrizione delle associazioni di file, vedere Tipi di file.

È anche possibile recuperare il nome di un'applicazione usando questa interfaccia. Usare il metodo IQueryAssociations::GetString. Impostare il parametro str su ASSOCSTR_FRIENDLYAPPNAME.

Per usare questa interfaccia, è prima necessario recuperare un puntatore. In genere, si recupera un puntatore QueryInterface chiamando il metodo IShellFolder::GetUIObjectOf di un oggetto Shell. È anche possibile recuperare un puntatore all'interfaccia chiamando AssocCreate (impostare clsid su CLSID_QueryAssociations). Inizializzare l'interfaccia con IQueryAssociations::Init. Questo metodo imposta la chiave radice che verrà utilizzata quando si chiama uno dei tre metodi rimanenti per recuperare informazioni dal Registro di sistema. Verranno visualizzati solo sotto la chiave radice. È necessario rilasciare l'interfaccia quando non è più necessaria.

L'interfaccia IQueryAssociations è utile se è necessario eseguire ripetutamente una query sul Registro di sistema per ottenere informazioni. Dopo l'inizializzazione dell'interfaccia, l'overhead della chiamata ai vari metodi è relativamente ridotto. Esistono anche diverse funzioni correlate, elencate nella sezione Vedere anche , che consentono di recuperare le stesse informazioni dal Registro di sistema con una singola chiamata di funzione. Anche se sono più semplici da usare, causano il sovraccarico della creazione e dell'inizializzazione di IQueryAssociations ogni volta che vengono chiamati. Per questo motivo, sono più adatti per l'uso singolo.

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

Vedi anche

AssocQueryKey

AssocQueryString

AssocQueryStringByKey