Funzione AssocQueryKeyW (shlwapi.h)
Cerca e recupera una chiave correlata a un file o a un'associazione di protocolli dal Registro di sistema.
Sintassi
LWSTDAPI AssocQueryKeyW(
[in] ASSOCF flags,
[in] ASSOCKEY key,
[in] LPCWSTR pszAssoc,
[in] LPCWSTR pszExtra,
[out] HKEY *phkeyOut
);
Parametri
[in] flags
Tipo: ASSOCF
Flag che possono essere usati per controllare la ricerca. Può essere qualsiasi combinazione di valori ASSOCF , ad eccezione del fatto che è possibile includere un solo valore ASSOCF_INIT.
[in] key
Tipo: ASSOCKEY
Valore ASSOCKEY che specifica il tipo di chiave da restituire.
[in] pszAssoc
Tipo: LPCTSTR
Puntatore a una stringa con terminazione null usata per determinare la chiave radice. È possibile usare quattro tipi di stringhe.
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. Document.8.
Nome eseguibile
Nome del file di .exe di un'applicazione. Il flag ASSOCF_OPEN_BYEXENAME deve essere impostato nei flag.
[in] pszExtra
Tipo: LPCTSTR
Puntatore a una stringa con terminazione null facoltativa con informazioni aggiuntive sulla posizione della stringa. In genere è impostato su un verbo shell, ad esempio aperto. Impostare questo parametro su NULL se non viene usato.
[out] phkeyOut
Tipo: HKEY*
Puntatore al valore HKEY della chiave.
Valore restituito
Tipo: HRESULT
Restituisce S_OK se ha esito positivo o un valore di errore COM in caso contrario.
Commenti
Questa funzione è un wrapper per l'interfaccia IQueryAssociations . È destinato a semplificare il processo di utilizzo dell'interfaccia. Per altre informazioni sul funzionamento delle funzioni di associazione di file e protocollo, vedere IQueryAssociations.
Nota
L'intestazione shlwapi.h definisce AssocQueryKey come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 | Shlwapi.dll (versione 5.0 o successiva) |