Partager via


Lier des clés de chaîne de contexte

Ensemble de clés de chaîne qui sont utilisées avec la méthode IBindCtx::RegisterObjectParam pour spécifier un contexte de liaison.

Constant Description
STR_AVOID_DRIVE_RESTRICTION_POLICY
Introduit dans Windows XP SP2. Spécifiez ce contexte de liaison pour permettre aux clients de la source de données de remplacer la stratégie de lettre de lecteur masquée et d’activer l’accès aux objets d’affichage pour les sources de données sur les lecteurs bloqués.
Utilisé avec IShellFolder::BindToObject ou IShellItem::BindToHandler.
Le système prend en charge les stratégies contrôlées par l’administrateur qui masquent les lettres de lecteur spécifiées pour empêcher les utilisateurs d’accéder à ces lecteurs via Windows Explorer. Lorsque cette stratégie est active, l’affichage des objets et autres gestionnaires créés avec la méthode IShellFolder::CreateViewObject échouent lorsqu’ils sont appelés sur des lecteurs bloqués par la stratégie.
STR_BIND_DELEGATE_CREATE_OBJECT
Introduit dans Windows Vista. Spécifiez ce contexte de liaison pour que la méthode IShellFolder::BindToObject utilise l’objet spécifié par le paramètre pbc pour créer l’objet cible ; dans ce cas, l’objet spécifié par le paramètre punk dans l’appel IBindCtx::RegisterObjectParam doit implémenter l’interface ICreateObject .
Utilisé avec IShellFolder::BindToObject ou IShellItem::BindToHandler.
STR_BIND_FOLDER_ENUM_MODE
Introduit dans Windows 7. Passé à IShellFolder::P arseDisplayName avec une valeur FOLDER_ENUM_MODE pour contrôler le mode d’énumération de l’élément analysé. La valeur FOLDER_ENUM_MODE est transmise dans le contexte de liaison via un objet qui implémente IObjectWithFolderEnumMode.
Les éléments avec différents modes d’énumération se comparent canoniquement (SHCIDS_CANONICALONLY) différents, car ils énumèrent différents ensembles d’éléments.
Si un élément ne prend pas en charge le mode énumération (parce qu’il ne s’agit pas d’un dossier ou qu’il ne fournit pas le mode d’énumération), il est créé dans le mode d’énumération par défaut.
STR_BIND_FOLDERS_READ_ONLY
Introduit dans Windows 7. Passé à IShellFolder::P arseDisplayName avec STR_FILE_SYS_BIND_DATA. Cela force l’analyse simple tout en recherchant Desktop.ini fichiers le long du chemin d’accès à partir duquel obtenir une chaîne de nom localisée. Cela évite de rechercher des dossiers le long du chemin d’accès, ce qui, dans le cas d’un dossier qui représente un serveur ou un partage, peut prendre beaucoup de temps et de ressources. Desktop.ini fichiers étant mis en cache à certains emplacements, il sera au moins aussi efficace que l’analyse des attributs de dossiers, puis l’analyse des Desktop.ini si ce dossier doit devenir en lecture seule.
STR_BIND_FORCE_FOLDER_SHORTCUT_RESOLVE
Introduit dans Windows XP SP2. Spécifiez ce contexte de liaison pour forcer un raccourci de dossier pour résoudre le lien qui pointe vers sa cible.
Un raccourci de dossier est un élément de dossier qui pointe vers un autre élément de dossier dans le même espace de noms, à l’aide d’un lien (raccourci) pour contenir l’IDList de la cible. Le lien est résolu pour suivre la cible en cas de déplacement ou de renommage. Par exemple, le dossier Mes emplacements réseau Windows XP et le dossier Ordinateur Windows Vista peuvent contenir des raccourcis de dossier créés avec l’Assistant Ajouter un emplacement réseau . Pour améliorer les performances, la méthode IShellFolder::BindToObject ne résout pas les liens vers le dossier réseau par défaut.
Utilisé avec IShellFolder::BindToObject ou IShellItem::BindToHandler.
STR_DONT_PARSE_RELATIVE
Introduit dans Windows XP. Spécifiez ce contexte de liaison pour empêcher un appel à la méthode IShellFolder::P arseDisplayName sur le dossier Desktop de traiter les chemins d’accès relatifs comme relatifs au bureau ; dans ce cas, l’analyse échoue lorsque ce contexte de liaison est spécifié.
STR_DONT_RESOLVE_LINK
Introduit dans Windows Vista. Spécifiez ce contexte de liaison pour indiquer à un objet IShellItem de ne pas résoudre la cible de lien obtenue lors de l’utilisation du GUID BHID_LinkTargetItem dans IShellItem::BindToHandler.
STR_FILE_SYS_BIND_DATA
Introduit dans Windows XP. Spécifiez ce contexte de liaison pour fournir des métadonnées de fichier à la méthode IShellFolder::P arseDisplayName , qui est utilisée au lieu de tenter de récupérer les métadonnées de fichier réelles. L’objet associé doit implémenter IFileSystemBindData et peut éventuellement également implémenter IFileSystemBindData2. Par défaut, la méthode IShellFolder::P arseDisplayName vérifie que le fichier existe et utilise les métadonnées réelles du fichier pour remplir la liste d’ID.
STR_FILE_SYS_BIND_DATA_WIN7_FORMAT
Introduit dans Windows 8.1. Spécifiez ce contexte de liaison pour indiquer que les données fournies dans le contexte de liaison STR_FILE_SYS_BIND_DATA doivent être utilisées pour créer une liste ItemID au format Windows 7. »
STR_GET_ASYNC_HANDLER
Introduit dans Windows 7. Spécifiez ce contexte de liaison lorsque le gestionnaire est récupéré sur le même thread que l’interface utilisateur. Toutes les activités nécessitant beaucoup de mémoire, telles que celles qui impliquent un accès au disque ou au réseau, doivent être évitées.
STR_GPS_BESTEFFORT
Introduit dans Windows Vista. Spécifiez ce contexte de liaison lors de la demande d’un gestionnaire IPropertySetStorage ou IPropertyStore . Cette valeur est utilisée avec IShellFolder::BindToObject. Pour plus d’informations, consultez l’indicateur GPS_BESTEFFORT .
STR_GPS_DELAYCREATION
Introduit dans Windows Vista. Spécifiez ce contexte de liaison lors de la demande d’un gestionnaire IPropertySetStorage ou IPropertyStore . Cette valeur est utilisée avec IShellFolder::BindToObject. Pour plus d’informations, consultez l’indicateur GPS_DELAYCREATION.
STR_GPS_FASTPROPERTIESONLY
Introduit dans Windows Vista. Spécifiez ce contexte de liaison lors de la demande d’un gestionnaire IPropertySetStorage ou IPropertyStore . Cette valeur est utilisée avec IShellFolder::BindToObject. Pour plus d’informations , consultez l’indicateur GPS_FASTPROPERTIESONLY .
STR_GPS_HANDLERPROPERTIESONLY
Introduit dans Windows Vista. Spécifiez ce contexte de liaison lors de la demande d’un gestionnaire IPropertySetStorage ou IPropertyStore . Cette valeur est utilisée avec IShellFolder::BindToObject. Pour plus d’informations , consultez l’indicateur GPS_HANDLERPROPERTIESONLY .
STR_GPS_NO_OPLOCK
Introduit dans Windows 7. Spécifiez ce contexte de liaison lors de la demande d’un gestionnaire IPropertySetStorage ou IPropertyStore . Cette valeur est utilisée avec IShellFolder::BindToObject. Pour plus d’informations , consultez l’indicateur GPS_NO_OPLOCK .
STR_GPS_OPENSLOWITEM
Introduit dans Windows Vista. Spécifiez ce contexte de liaison lors de la demande d’un gestionnaire IPropertySetStorage ou IPropertyStore . Cette valeur est utilisée avec IShellFolder::BindToObject. Pour plus d’informations , consultez l’indicateur GPS_OPENSLOWITEM .
STR_IFILTER_FORCE_TEXT_FILTER_FALLBACK
Windows Vista uniquement. Spécifiez ce contexte de liaison pour provoquer un appel à la méthode IShellFolder::BindToObject qui demande à l’interface IFilter qu’un objet de système de fichiers retourne un filtre de texte si aucun autre filtre n’est disponible. Cette valeur n’est pas définie à partir de Windows 7.
STR_IFILTER_LOAD_DEFINED_FILTER
Windows Vista uniquement. Spécifiez ce contexte de liaison pour provoquer un appel à la méthode IShellFolder::BindToObject qui demande à l’interface IFilter qu’un objet de système de fichiers ne retourne pas de filtre de secours si aucun filtre inscrit n’est trouvé.
STR_INTERNAL_NAVIGATE
Introduit dans Windows Vista. Spécifiez ce contexte de liaison pour permettre le chargement de l’historique à partir d’un flux pour une navigation interne lorsque la méthode IPersistHistory::LoadHistory est appelée. Une navigation interne est une navigation dans la même vue.
STR_INTERNETFOLDER_PARSE_ONLY_URLMON_BINDABLE
Introduit dans Windows 7. Spécifiez ce contexte de liaison avec STR_PARSE_PREFER_FOLDER_BROWSING lorsque le client souhaite que les gestionnaires de dossiers Internet Shell génèrent une IDList pour toute URL valide si un dossier de type DAV ne peut pas être créé pour cette URL. L’URL n’est pas vérifiée pour exister ; seule sa syntaxe est vérifiée et qu’elle dispose d’un gestionnaire de protocole inscrit.
STR_ITEM_CACHE_CONTEXT
Introduit dans Windows 7. Spécifiez ce contexte de liaison pour indiquer aux implémentations de IShellFolder::P arseDisplayName et IPersistFolder3::InitializeEx de mettre en cache les objets d’assistance nécessitant beaucoup de mémoire qui peuvent exister entre les instanciations d’éléments Shell au lieu de recréer ces objets chaque fois qu’un élément Shell est créé. L’objet associé est un autre objet de contexte de liaison, initialement vide. Cela doit entraîner un objet de contexte de liaison distinct, accessible via IBindCtx::GetObjectParam ou IBindCtx::Register.ObjectParam.
Un appelant doit choisir ce comportement en fournissant ce paramètre de contexte de liaison lors de l’appel de SHCreateItemFromParsingName. En procédant ainsi, vous optimisez le comportement de la liaison à plusieurs noms d’analyse successivement. La durée de vie de l’objet de contexte de liaison doit s’étendre sur plusieurs instances d’éléments Shell et leurs contextes de liaison individuels.
STR_NO_VALIDATE_FILENAME_CHARS
Introduit dans Windows Vista. Spécifiez ce contexte de liaison pour autoriser l’affichage de caractères de nom de fichier non valides dans les noms de fichiers. Par défaut, un appel à la méthode IShellFolder::P arseDisplayName rejette les caractères non valides dans les noms de fichiers. Ce contexte de liaison n’est significatif qu’en conjonction avec le contexte de liaison STR_FILE_SYS_BIND_DATA.
STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS
Introduit dans Windows Vista. Spécifiez ce contexte de liaison pour activer un appel à la méthode IShellFolder::P arseDisplayName dans le dossier Desktop pour analyser les URL. Si ce contexte de liaison est spécifié, il remplace STR_PARSE_PREFER_WEB_BROWSING.
STR_PARSE_AND_CREATE_ITEM
Introduit dans Windows 7. Spécifiez ce contexte de liaison pour indiquer à l’implémentation d’une source de données IShellFolder::P arseDisplayName d’optimiser le comportement de SHCreateItemFromParsingName.
Normalement, SHCreateItemFromParsingName effectue deux opérations de liaison sur le nom à analyser : une à et une vers IShellFolder::P arseDisplayName et une pour créer l’élément Shell. Lorsque le contexte de liaison STR_PARSE_AND_CREATE_ITEM est pris en charge, la deuxième liaison est évitée en créant l’élément Shell pendant la liaison IShellFolder::P arseDisplayName et en stockant l’élément Shell via IParseAndCreateItem::SetItem. SHCreateItemFromParsingName utilise ensuite l’élément Shell stocké au lieu d’en créer un.
Ce paramètre s’applique au dernier élément du nom analysé. Par instance, dans le nom « C:\Folder1\File.txt , les données s’appliquent à File.txt.
STR_PARSE_DONT_REQUIRE_VALIDATED_URLS
Windows Vista uniquement. Spécifiez que, lors de l’analyse d’une URL, ce contexte de liaison ne doit pas exiger que l’URL existe avant de générer un IDList pour celui-ci. Spécifiez ce contexte de liaison avec STR_PARSE_PREFER_FOLDER_BROWSING lorsque le client souhaite que les gestionnaires de dossiers Internet Shell génèrent un IDList pour l’URL si un dossier DAV ne peut pas être créé pour l’URL donnée.
STR_PARSE_PARTIAL_IDLIST
Introduit dans Windows Vista. Spécifiez ce contexte de liaison pour passer l’élément d’origine en cours d’analyse lorsque cet élément est stocké en tant qu’objet IShellItem qui implémente également l’interface IParentAndItem . Avant Windows 7, cette valeur n’était pas définie dans un fichier d’en-tête. Il peut être défini par l’appelant ou passé en tant que valeur de chaîne de L"ParseOriginalItem ». À partir de Windows 7, la valeur est définie dans Shlobj.h. Notez qu’il s’agit d’un en-tête différent des autres constantes STR.
STR_PARSE_PREFER_FOLDER_BROWSING
Introduit dans Windows XP. Spécifiez ce contexte de liaison pour activer un appel à la méthode IShellFolder::P arseDisplayName dans le dossier Desktop pour analyser les URL comme s’il s’agissait de dossiers. Utilisez ce contexte de liaison pour établir une liaison à un serveur WebDAV.
STR_PARSE_PREFER_WEB_BROWSING
Introduit dans Windows Vista. Spécifiez ce contexte de liaison pour empêcher un appel à la méthode IShellFolder::P arseDisplayName dans les URL d’analyse du dossier Desktop . Ce contexte de liaison peut être remplacé par STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS.
STR_PARSE_PROPERTYSTORE
Introduit dans Windows Vista. Spécifiez ce contexte de liaison pour remplacer le magasin de propriétés par défaut utilisé par la méthode IShellFolder::P arseDisplayName , puis utilisez le magasin de propriétés spécifié comme paramètre de liaison à la place. S’applique aux dossiers délégués.
STR_PARSE_SHELL_PROTOCOL_TO_FILE_OBJECTS
Introduit dans Windows XP SP2. Spécifiez ce contexte de liaison pour activer un appel à la méthode IShellFolder::P arseDisplayName sur le dossier Desktop pour utiliser la notation de préfixe « shell: » pour accéder aux fichiers.
STR_PARSE_SHOW_NET_DIAGNOSTICS_UI
Introduit dans Windows Vista. Spécifiez ce contexte de liaison pour qu’un appel à la méthode IShellFolder::P arseDisplayName affiche la boîte de dialogue diagnostics réseau si l’analyse d’un chemin d’accès réseau échoue.
STR_PARSE_SKIP_NET_CACHE
Introduit dans Windows Vista. Spécifiez ce contexte de liaison pour provoquer un appel à la méthode IShellFolder::P arseDisplayName pour ignorer la vérification du cache des partages réseau et contacter directement le serveur réseau. Les informations sur les partages réseau sont mises en cache pour améliorer les performances, et IShellFolder::P arseDisplayName vérifie ce cache par défaut.
STR_PARSE_TRANSLATE_ALIASES
Introduit dans Windows XP. Spécifiez ce contexte de liaison pour passer les propriétés analysées à la méthode IShellFolder::P arseDisplayName pour un espace de noms délégué. L’espace de noms peut utiliser les propriétés passées au lieu de tenter d’analyser le nom lui-même.
STR_PARSE_WITH_PROPERTIES
Windows Vista uniquement. Contexte de liaison d’analyse utilisé pour passer un ensemble de propriétés et le nom de l’élément lors de l’appel de IShellFolder::P arseDisplayName. L’objet dans le contexte de liaison implémente IPropertyStore et est récupéré en appelant IBindCtx::GetObjectParam.
DBFolder est une source de données Shell qui représente des éléments dans les résultats de recherche et les vues basées sur les requêtes. DBFolder récupère ces éléments en interrogeant le système Windows Search. Les éléments dans les résultats de la recherche sont identifiés via un schéma de protocole, par exemple « file: » ou « mapi: ». DBFolder fournit le comportement de ces éléments en déléguant aux sources de données Shell créées pour ces protocoles. Pour plus d’informations, consultez Développement de compléments de gestionnaire de protocole.
Lorsque DBFolder délègue son opération d’analyse aux sources de données shell qui prennent en charge les protocoles Windows Search, ce contexte de liaison fournit l’accès aux valeurs qui ont été retournées dans le résultat de la requête pour cet élément. Notamment :

Ce contexte de liaison peut également être utilisé pour analyser un élément DBFolder si un client a un ensemble de propriétés qui définissent l’élément. Dans ce cas, un nom vide doit être passé à IShellFolder::P arseDisplayName.
Avant Windows 7, cette valeur n’était pas définie dans un fichier d’en-tête. Il peut être défini par l’appelant ou passé comme valeur de chaîne : L"ParseWithProperties". À partir de Windows 7, la valeur est définie dans Shlobj.h. Notez qu’il s’agit d’un en-tête différent de celui où les autres constantes STR sont définies.
STR_PROPERTYBAG_PARAM
Introduit dans Windows 8. Spécifiez ce contexte de liaison pour indiquer que le paramètre de contexte de liaison est un conteneur de propriétés (IPropertyBag) utilisé pour passer des valeurs VARIANT dans le contexte de liaison. Pour plus d’informations, consultez la section Remarques.
STR_SKIP_BINDING_CLSID
Introduit dans Windows XP. Spécifiez ce contexte de liaison pour que les appels aux méthodes IShellFolder::P arseDisplayName ou IShellFolder::BindToObject ignorent une extension d’espace de noms Shell particulière lors de l’analyse ou de la liaison. Le CLSID de l’espace de noms à ignorer est fourni par la méthode IPersist::GetClassID du paramètre bind.
Note: Introduite dans Windows 2000 SP3, cette valeur a été définie dans Shlobj.h jusqu’à Windows XP, quand elle a été déplacée vers Shobjidl.h.
STR_TRACK_CLSID
Non utilisé.

Notes

Les contextes de liaison sont utilisés pour passer des paramètres facultatifs aux fonctions qui ont un paramètre IBindCtx*. Ces paramètres sont exprimés sous forme d’objets COM et peuvent implémenter des interfaces utilisées pour modéliser les données de paramètre. Certains contextes de liaison représentent une valeur booléenne, où TRUE indique un objet qui implémente uniquement IUnknown et FALSE indique qu’aucun objet n’est présent.

IShellFolder::P arseDisplayName, IShellFolder::BindToObject et IShellItem::BindToHandler prennent un contexte de liaison et vous pouvez leur transmettre des paramètres via ce contexte de liaison.

Certains contextes de liaison sont spécifiques à certains types de gestionnaires ou implémentations de sources de données.

Les paramètres de contexte de liaison sont définis pour une utilisation avec une fonction ou une méthode spécifique.

Lorsque vous demandez un magasin de propriétés via IShellFolder, vous pouvez spécifier l’équivalent de GPS_DEFAULT en passant un paramètre IBindCtx null. Vous pouvez également spécifier l’équivalent de GPS_READWRITE en passant un mode de STGM_READWRITE | STGM_EXCLUSIVE dans le contexte de liaison.

Le conteneur de propriétés spécifié par l’objet de contexte de liaison STR_PROPERTYBAG_PARAM contient des valeurs supplémentaires auxquelles vous pouvez accéder avec les méthodes IPropertyBag::Read et IPropertyBag::Write .

Nom de la propriété Type Description
STR_ENUM_ITEMS_FLAGS VT_UI4 Introduit dans Windows 8. Spécifie une valeur SHCONTF à passer à IShellFolder::EnumObjects lorsque vous appelez IShellItem::BindToHandler avec BHID_EnumItems.
STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL VT_BOOL Introduit dans Windows 7. La méthode IShellFolder::P arseDisplayName définit cette propriété pour indiquer à l’appelant que l’IDList renvoyé était lié au ProgID spécifié avec STR_PARSE_WITH_EXPLICIT_PROGID ou à l’application spécifiée avec STR_PARSE_WITH_EXPLICIT_ASSOCAPP. Lorsque STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL est absent, le ProgID ou l’application n’était pas lié à l’IDList.
STR_PARSE_WITH_EXPLICIT_ASSOCAPP VT_BSTR Introduit dans Windows 7. Spécifiez cette propriété pour provoquer un appel à la méthode IShellFolder::P arseDisplayName pour renvoyer un IDList lié au gestionnaire d’association de type de fichier pour l’application.
STR_PARSE_WITH_EXPLICIT_PROGID VT_BSTR Introduit dans Windows 7. Spécifiez cette propriété pour provoquer un appel à la méthode IShellFolder::P arseDisplayName pour renvoyer un IDList lié au gestionnaire d’association de fichiers du ProgID fourni.

 

Consultez l’exemple Analyse avec des paramètres pour obtenir un exemple d’utilisation de valeurs de contexte de liaison.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2008 R2 [applications de bureau uniquement]
En-tête
Shobjidl.h
IDL
Shobjidl.idl