Énumération ASSOCF

Article
06/13/2023

Fournit des informations aux méthodes d’interface IQueryAssociations .

Syntaxe

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;

Constantes

ASSOCF_NONE

Aucune des options suivantes n’est définie.

ASSOCF_INIT_NOREMAPCLSID

Indique aux méthodes d’interface IQueryAssociations de ne pas mapper les valeurs CLSID aux valeurs ProgID.

ASSOCF_INIT_BYEXENAME

Identifie la valeur du paramètre pwszAssoc de IQueryAssociations::Init en tant que nom de fichier exécutable. Si cet indicateur n’est pas défini, la clé racine est définie sur le ProgID associé à la clé .exe au lieu du ProgID du fichier exécutable.

ASSOCF_OPEN_BYEXENAME

Identique à ASSOCF_INIT_BYEXENAME.

ASSOCF_INIT_DEFAULTTOSTAR

Spécifie que lorsqu’une méthode IQueryAssociations ne trouve pas la valeur demandée sous la clé racine, elle doit tenter de récupérer la valeur comparable à partir de la * sous-clé.

ASSOCF_INIT_DEFAULTTOFOLDER

Spécifie que lorsqu’une méthode IQueryAssociations ne trouve pas la valeur demandée sous la clé racine, elle doit tenter de récupérer la valeur comparable à partir de la sous-clé Folder .

ASSOCF_NOUSERSETTINGS

Spécifie que seules les HKEY_CLASSES_ROOT doivent faire l’objet d’une recherche et que HKEY_CURRENT_USER doivent être ignorées.

ASSOCF_NOTRUNCATE

Spécifie que la chaîne de retour ne doit pas être tronquée. Au lieu de cela, retournez une valeur d’erreur et la taille requise pour la chaîne complète.

ASSOCF_VERIFY

Indique aux méthodes IQueryAssociations de vérifier que les données sont exactes. Ce paramètre permet aux méthodes IQueryAssociations de lire les données du disque dur de l’utilisateur à des fins de vérification. Par exemple, ils peuvent case activée le nom convivial dans le Registre par rapport à celui stocké dans le fichier .exe. La définition de cet indicateur réduit généralement l’efficacité de la méthode.

ASSOCF_REMAPRUNDLL

Indique aux méthodes IQueryAssociations d’ignorer Rundll.exe et de retourner des informations sur sa cible. En règle générale, les méthodes IQueryAssociations retournent des informations sur le premier .exe ou .dll dans une chaîne de commande. Si une commande utilise Rundll.exe, la définition de cet indicateur indique à la méthode d’ignorer Rundll.exe et de retourner des informations sur sa cible.

ASSOCF_NOFIXUPS

Indique aux méthodes IQueryAssociations de ne pas corriger les erreurs dans le Registre, telles que le nom convivial d’une fonction qui ne correspond pas à celui trouvé dans le fichier .exe.

ASSOCF_IGNOREBASECLASS

Spécifie que la valeur BaseClass doit être ignorée.

ASSOCF_INIT_IGNOREUNKNOWN

Introduit dans Windows 7. Spécifie que le ProgID « Unknown » doit être ignoré ; au lieu de cela, échoue.

ASSOCF_INIT_FIXED_PROGID

Introduit dans Windows 8. Spécifie que le ProgID fourni doit être mappé à l’aide des valeurs système par défaut, plutôt que des valeurs par défaut de l’utilisateur actuel.

ASSOCF_IS_PROTOCOL

Introduit dans Windows 8. Spécifie que la valeur est un protocole et doit être mappée à l’aide des valeurs par défaut de l’utilisateur actuel.

ASSOCF_INIT_FOR_FILE

Introduit dans Windows 8.1. Spécifie que le ProgID correspond à une association basée sur une extension de fichier. Utilisez avec ASSOCF_INIT_FIXED_PROGID.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Shlwapi.h

Voir aussi

AssocQueryKeyAssocQueryStringAssocQueryStringByKey