Funzione AssocQueryKeyA (shlwapi.h)

Articolo
03/05/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 è 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. Documento.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 facoltativa con terminazione Null 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 in caso di esito positivo o un valore di errore COM in caso contrario.

Commenti

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 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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)

Condividi tramite