Enumerazione ASSOCF

Articolo
06/13/2023

Fornisce informazioni ai metodi di interfaccia IQueryAssociations .

Sintassi

typedef enum  {
    ASSOCF_NONE                  = 0x00000000,  
    ASSOCF_INIT_NOREMAPCLSID     = 0x00000001,  
    ASSOCF_INIT_BYEXENAME        = 0x00000002,  
    ASSOCF_OPEN_BYEXENAME        = 0x00000002,  
    ASSOCF_INIT_DEFAULTTOSTAR    = 0x00000004,  
    ASSOCF_INIT_DEFAULTTOFOLDER  = 0x00000008,  
    ASSOCF_NOUSERSETTINGS        = 0x00000010,  
    ASSOCF_NOTRUNCATE            = 0x00000020,  
    ASSOCF_VERIFY                = 0x00000040,  
    ASSOCF_REMAPRUNDLL           = 0x00000080,  
    ASSOCF_NOFIXUPS              = 0x00000100,  
    ASSOCF_IGNOREBASECLASS       = 0x00000200,  
    ASSOCF_INIT_IGNOREUNKNOWN    = 0x00000400,  
    ASSOCF_INIT_FIXED_PROGID     = 0x00000800,  
    ASSOCF_IS_PROTOCOL           = 0x00001000,  
    ASSOCF_INIT_FOR_FILE         = 0x00002000
} ASSOCF;

Costanti

ASSOCF_NONE

Nessuna delle opzioni seguenti è impostata.

ASSOCF_INIT_NOREMAPCLSID

Indica ai metodi di interfaccia IQueryAssociations di non eseguire il mapping dei valori CLSID ai valori ProgID.

ASSOCF_INIT_BYEXENAME

Identifica il valore del parametro pwszAssoc di IQueryAssociations::Init come nome file eseguibile. Se questo flag non è impostato, la chiave radice verrà impostata sul ProgID associato alla chiave .exe anziché al progID del file eseguibile.

ASSOCF_OPEN_BYEXENAME

Identico a ASSOCF_INIT_BYEXENAME.

ASSOCF_INIT_DEFAULTTOSTAR

Specifica che quando un metodo IQueryAssociations non trova il valore richiesto nella chiave radice, deve tentare di recuperare il valore paragonabile dalla * sottochiave.

ASSOCF_INIT_DEFAULTTOFOLDER

Specifica che quando un metodo IQueryAssociations non trova il valore richiesto nella chiave radice, deve tentare di recuperare il valore paragonabile dalla sottochiave Folder .

ASSOCF_NOUSERSETTINGS

Specifica che è necessario eseguire la ricerca solo HKEY_CLASSES_ROOT e che HKEY_CURRENT_USER deve essere ignorato.

ASSOCF_NOTRUNCATE

Specifica che la stringa restituita non deve essere troncata. Restituisce invece un valore di errore e le dimensioni necessarie per la stringa completa.

ASSOCF_VERIFY

Indica ai metodi IQueryAssociations di verificare che i dati siano accurati. Questa impostazione consente ai metodi IQueryAssociations di leggere i dati dal disco rigido dell'utente per la verifica. Ad esempio, possono controllare il nome descrittivo nel Registro di sistema rispetto a quello archiviato nel file di .exe. L'impostazione di questo flag riduce in genere l'efficienza del metodo.

ASSOCF_REMAPRUNDLL

Indica ai metodi IQueryAssociations di ignorare Rundll.exe e restituire informazioni sulla destinazione. In genere i metodi IQueryAssociations restituiscono informazioni sulla prima .exe o .dll in una stringa di comando. Se un comando usa Rundll.exe, l'impostazione di questo flag indica al metodo di ignorare Rundll.exe e restituire informazioni sulla destinazione.

ASSOCF_NOFIXUPS

Indica ai metodi IQueryAssociations di non correggere gli errori nel Registro di sistema, ad esempio il nome descrittivo di una funzione che non corrisponde a quello trovato nel file .exe.

ASSOCF_IGNOREBASECLASS

Specifica che il valore BaseClass deve essere ignorato.

ASSOCF_INIT_IGNOREUNKNOWN

Introdotta in Windows 7. Specifica che il progID "Sconosciuto" deve essere ignorato; invece, non riuscire.

ASSOCF_INIT_FIXED_PROGID

Introdotta in Windows 8. Specifica che il progID fornito deve essere mappato usando le impostazioni predefinite del sistema anziché le impostazioni predefinite dell'utente corrente.

ASSOCF_IS_PROTOCOL

Introdotta in Windows 8. Specifica che il valore è un protocollo e deve essere mappato usando le impostazioni predefinite dell'utente corrente.

ASSOCF_INIT_FOR_FILE

Introdotta in Windows 8.1. Specifica che progID corrisponde a un'associazione basata sull'estensione di file. Usare insieme a ASSOCF_INIT_FIXED_PROGID.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Shlwapi.h

Vedi anche

AssocQueryKey AssocQueryStringAssocQueryStringByKey