Funzione AssocQueryKeyA (shlwapi.h)

Articolo
11/20/2024

Cerca e recupera una chiave correlata a un'associazione di file o protocollo dal Registro di sistema.

Sintassi

LWSTDAPI AssocQueryKeyA(
  [in]  ASSOCF   flags,
  [in]  ASSOCKEY key,
  [in]  LPCSTR   pszAssoc,
  [in]  LPCSTR   pszExtra,
  [out] HKEY     *phkeyOut
);

Parametri

[in] flags

Tipo: ASSOCF

Flag che possono essere utilizzati per controllare la ricerca. Può essere qualsiasi combinazione di valori ASSOCF, ad eccezione del fatto che può essere incluso 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 nome 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. Viene 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 in caso di esito positivo o un valore di errore COM in caso contrario.

Osservazioni

Questa funzione è un wrapper per l'interfaccia IQueryAssociations. È progettato per semplificare il processo di utilizzo dell'interfaccia . Per altre informazioni sul funzionamento delle funzioni di associazione di file e protocolli, 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 5.0 o successiva)

Condividi tramite