Énumération ASSOCSTR (shlwapi.h)

  • Article

Utilisé par IQueryAssociations ::GetString pour définir le type de chaîne à retourner.

Syntax

typedef enum {
  ASSOCSTR_COMMAND = 1,
  ASSOCSTR_EXECUTABLE,
  ASSOCSTR_FRIENDLYDOCNAME,
  ASSOCSTR_FRIENDLYAPPNAME,
  ASSOCSTR_NOOPEN,
  ASSOCSTR_SHELLNEWVALUE,
  ASSOCSTR_DDECOMMAND,
  ASSOCSTR_DDEIFEXEC,
  ASSOCSTR_DDEAPPLICATION,
  ASSOCSTR_DDETOPIC,
  ASSOCSTR_INFOTIP,
  ASSOCSTR_QUICKTIP,
  ASSOCSTR_TILEINFO,
  ASSOCSTR_CONTENTTYPE,
  ASSOCSTR_DEFAULTICON,
  ASSOCSTR_SHELLEXTENSION,
  ASSOCSTR_DROPTARGET,
  ASSOCSTR_DELEGATEEXECUTE,
  ASSOCSTR_SUPPORTED_URI_PROTOCOLS,
  ASSOCSTR_PROGID,
  ASSOCSTR_APPID,
  ASSOCSTR_APPPUBLISHER,
  ASSOCSTR_APPICONREFERENCE,
  ASSOCSTR_MAX
} ASSOCSTR;

Constantes

 
ASSOCSTR_COMMAND
Valeur : 1
Chaîne de commande associée à un verbe Shell.
ASSOCSTR_EXECUTABLE
Exécutable d’une chaîne de commande de verbe Shell. Par exemple, cette chaîne est trouvée en tant que valeur (Par défaut) pour une sous-clé telle que

\ HKEY_CLASSES_ROOTApplicationname\Shell\Ouvert\commande. Si la commande utilise Rundll.exe, définissez l’indicateur ASSOCF_REMAPRUNDLL dans le paramètre flags de IQueryAssociations ::GetString pour récupérer l’exécutable cible.

Attention  

Toutes les associations d’applications n’ont pas d’exécutables. Ne supposez pas qu’un exécutable sera toujours présent.


 

Ce type de chaîne identifie le code qui sera appelé dans l’implémentation du verbe.
ASSOCSTR_FRIENDLYDOCNAME
Nom convivial d’un type de document.
ASSOCSTR_FRIENDLYAPPNAME
Nom convivial d’un fichier exécutable.
ASSOCSTR_NOOPEN
Ignorez les informations associées à la sous-clé ouverte .
ASSOCSTR_SHELLNEWVALUE
Regardez sous la sous-clé ShellNouveau .
ASSOCSTR_DDECOMMAND
Modèle pour les commandes DDE.
ASSOCSTR_DDEIFEXEC
Commande DDE à utiliser pour créer un processus.
ASSOCSTR_DDEAPPLICATION
Nom de l’application dans une diffusion DDE.
ASSOCSTR_DDETOPIC
Nom de la rubrique dans une diffusion DDE.
ASSOCSTR_INFOTIP
Correspond à la valeur de Registre InfoTip. Renvoie un conseil d’informations pour un élément, ou une liste de propriétés sous la forme d’un IPropertyDescriptionList à partir duquel créer un conseil d’informations, par exemple lors du pointage du curseur sur un nom de fichier. La liste des propriétés peut être analysée avec PSGetPropertyDescriptionListFromString.
ASSOCSTR_QUICKTIP
Introduit dans Internet Explorer 6. Correspond à la valeur de Registre QuickTip. Identique à ASSOCSTR_INFOTIP, sauf qu’il retourne toujours une liste de noms de propriétés sous la forme d’un IPropertyDescriptionList. La différence entre cette valeur et ASSOCSTR_INFOTIP est que cela retourne des propriétés qui sont sécurisées pour tous les scénarios qui entraînent une récupération lente des propriétés, comme les réseaux hors connexion ou lents. Certaines des propriétés retournées par ASSOCSTR_INFOTIP peuvent ne pas convenir aux scénarios de récupération lente des propriétés. La liste des propriétés peut être analysée avec PSGetPropertyDescriptionListFromString.
ASSOCSTR_TILEINFO
Introduit dans Internet Explorer 6. Correspond à la valeur de Registre TileInfo. Contient la liste des propriétés à afficher pour un type de fichier particulier dans une fenêtre Windows Explorer en mode vignette. Cela est identique à ASSOCSTR_INFOTIP, mais, comme ASSOCSTR_QUICKTIP, il retourne également une liste de noms de propriétés sous la forme d’un IPropertyDescriptionList. La liste des propriétés peut être analysée avec PSGetPropertyDescriptionListFromString.
ASSOCSTR_CONTENTTYPE
Introduit dans Internet Explorer 6. Décrit un type général d’association de fichiers MIME, tel que image et bmp, afin que les applications puissent faire des hypothèses générales sur un type de fichier spécifique.
ASSOCSTR_DEFAULTICON
Introduit dans Internet Explorer 6. Retourne le chemin d’accès aux ressources d’icône à utiliser par défaut pour cette association. Les nombres positifs indiquent un index dans la table de ressources de la dll, tandis que les nombres négatifs indiquent un ID de ressource. Un exemple de syntaxe de la ressource est « c:\myfolder\myfile.dll,-1 ».
ASSOCSTR_SHELLEXTENSION
Introduit dans Internet Explorer 6. Pour un objet auquel une extension Shell est associée, vous pouvez l’utiliser pour récupérer le CLSID de cet objet d’extension Shell en transmettant une représentation sous forme de chaîne de l’IID de l’interface que vous souhaitez récupérer en tant que paramètre pwszExtra de IQueryAssociations ::GetString. Par exemple, si vous souhaitez récupérer un gestionnaire qui implémente l’interface IExtractImage , vous devez spécifier « {BB2E617C-0920-11d1-9A0B-00C04FC2D6C1} », qui est l’IID d’IExtractImage.
ASSOCSTR_DROPTARGET
Introduit dans Internet Explorer 8. Pour un verbe appelé via COM et l’interface IDropTarget , vous pouvez utiliser cet indicateur pour récupérer le CLSID de l’objet IDropTarget . Ce CLSID est inscrit dans la sous-clé DropTarget . Le verbe est spécifié dans le paramètre pwszExtra dans l’appel à IQueryAssociations ::GetString.

Ce type de chaîne identifie le code qui sera appelé dans l’implémentation du verbe.
ASSOCSTR_DELEGATEEXECUTE
Introduit dans Internet Explorer 8. Pour un verbe appelé via COM et l’interface IExecuteCommand , vous pouvez utiliser cet indicateur pour récupérer le CLSID de l’objet IExecuteCommand . Ce CLSID est inscrit dans la sous-clé de commande du verbe en tant qu’entrée DelegateExecute. Le verbe est spécifié dans le paramètre pwszExtra dans l’appel à IQueryAssociations ::GetString.

Ce type de chaîne identifie le code qui sera appelé dans l’implémentation du verbe.
ASSOCSTR_SUPPORTED_URI_PROTOCOLS
Valeur de chaîne des schémas de protocole URI. Par exemple, http:https:ftp:file: ou * indiquant tout.
ASSOCSTR_PROGID
Introduit dans Windows 10. ProgID fourni par l’application associée au type de fichier ou au schéma d’URI. Cela s’il est configuré par les utilisateurs dans leurs paramètres de programme par défaut.
ASSOCSTR_APPID
Introduit dans Windows 10. AppUserModelID de l’application associée au type de fichier ou au schéma d’URI. Il est configuré par les utilisateurs dans leurs paramètres de programme par défaut.
ASSOCSTR_APPPUBLISHER
Introduit dans Windows 10. Éditeur de l’application associée au type de fichier ou au schéma d’URI. Il est configuré par les utilisateurs dans leurs paramètres de programme par défaut.
ASSOCSTR_APPICONREFERENCE
Introduit dans Windows 10. Référence d’icône de l’application associée au type de fichier ou au schéma d’URI. Il est configuré par les utilisateurs dans leurs paramètres de programme par défaut.
ASSOCSTR_MAX
Valeur ASSOCSTR maximale définie, utilisée à des fins de validation.

Configuration requise

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