Binden von Kontextzeichenfolgenschlüsseln
Ein Satz von Zeichenfolgenschlüsseln, die mit der IBindCtx::RegisterObjectParam-Methode verwendet werden, um einen Bindungskontext anzugeben.
| Konstante | BESCHREIBUNG |
|---|---|
|
Eingeführt in Windows XP SP2. Geben Sie diesen Bindungskontext an, damit Clients der Datenquelle die Richtlinie für ausgeblendete Laufwerkbuchstaben außer Kraft setzen und den Zugriff auf die Ansichtsobjekte für Datenquellen auf den blockierten Laufwerken aktivieren können. Wird mit IShellFolder::BindToObject oder IShellItem::BindToHandler verwendet. Das System unterstützt vom Administrator gesteuerte Richtlinien, die angegebene Laufwerkbuchstaben ausblenden, um benutzern den Zugriff auf diese Laufwerke über den Windows zu blockieren. Wenn diese Richtlinie aktiv ist, führt dies dazu, dass Ansichtsobjekte und andere Handler, die mit der IShellFolder::CreateViewObject-Methode erstellt wurden, fehlschlagen, wenn sie auf Laufwerken aufgerufen werden, die durch die Richtlinie blockiert werden. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, damit die IShellFolder::BindToObject-Methode das vom pbc-Parameter angegebene Objekt verwendet, um das Zielobjekt zu erstellen. In diesem Fall muss das objekt, das durch den Parameter "parameter" im IBindCtx::RegisterObjectParam-Aufruf angegeben wird, die ICreateObject-Schnittstelle implementieren. Wird mit IShellFolder::BindToObject oder IShellItem::BindToHandler verwendet. |
|
Eingeführt in Windows 7. Wird an IShellFolder::P arseDisplayName mit einem FOLDER_ENUM_MODE übergeben, um den Enumerationsmodus des analysierten Elements zu steuern. Der FOLDER_ENUM_MODE wird im Bindungskontext über ein Objekt übergeben, das IObjectWithFolderEnumMode implementiert. Elemente mit unterschiedlichen Enumerationsmodi unterscheiden sich kanonisch (SHCIDS_CANONICALONLY), da sie unterschiedliche Sätze von Elementen aufzählen. Wenn ein Element den Enumerationsmodus nicht unterstützt (da es kein Ordner ist oder keinen Enumerationsmodus bietet), wird es im Standardenumerationsmodus erstellt. |
|
Eingeführt in Windows 7. Übergeben an IShellFolder::P arseDisplayName zusammen mit STR_FILE_SYS_BIND_DATA. Dies erzwingt eine einfache Analyse und Desktop.ini dateien entlang des Pfads, aus dem eine lokalisierte Namenszeichenfolge erhalten werden soll. Dadurch wird die Suche nach Ordnern entlang des Pfads vermieden, was im Fall eines Ordners, der einen Server oder eine Freigabe darstellt, viel Zeit und Ressourcen in Dies kann sehr lange dauern. Desktop.ini Dateien werden an einigen Speicherorten zwischengespeichert, sodass sie mindestens so effizient sind wie die Suche nach Ordnerattributen und die anschließende Suche nach dem Desktop.ini, wenn dieser Ordner ou int als schreibgeschützt festlegen soll. |
|
Eingeführt in Windows XP SP2. Geben Sie diesen Bindungskontext an, um eine Ordnerverknüpfung zu erzwingen, um den Link aufzulösen, der auf das Ziel verweist. Eine Ordnerverknüpfung ist ein Ordnerelement, das auf ein anderes Ordnerelement im gleichen Namespace verweist, indem ein Link (Verknüpfung) verwendet wird, um die IDList des Ziels zu speichern. Der Link wird aufgelöst, um das Ziel nachzuverfolgungen, falls es verschoben oder umbenannt wird. Beispielsweise können der Ordner Windows XP My Network Places und der Ordner Windows Vista Computer Ordnerverknüpfungen enthalten, die mit dem Assistenten zum Hinzufügen von Netzwerkspeicherorten erstellt wurden. Zur Verbesserung der Leistung löst die IShellFolder::BindToObject-Methode standardmäßig keine Links zum Netzwerkordner auf. Wird mit IShellFolder::BindToObject oder IShellItem::BindToHandler verwendet. |
|
Eingeführt in Windows XP. Geben Sie diesen Bindungskontext an, um zu verhindern, dass ein Aufruf der IShellFolder::P arseDisplayName-Methode im Desktopordner relative Pfade als relativ zum Desktop behandelt. in einem solchen Fall schlägt die Analyse fehl, wenn dieser Bindungskontext angegeben wird. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, um ein IShellItem anweisen, das link-Ziel, das bei Verwendung der BHID_LinkTargetItem-GUID in IShellItem::BindToHandlererhalten wurde, nicht aufzulösen. |
|
Eingeführt in Windows XP. Geben Sie diesen Bindungskontext an, um Dateimetadaten für die IShellFolder::P arseDisplayName-Methode anzugeben, die verwendet wird, anstatt zu versuchen, die eigentlichen Dateimetadaten abzurufen. Das zugeordnete Objekt muss IFileSystemBindData implementieren und kann optional auch IFileSystemBindData2 implementieren. Standardmäßig überprüft die IShellFolder::P arseDisplayName-Methode, ob die Datei vorhanden ist, und verwendet die tatsächlichen Metadaten der Datei, um die ID-Liste zu füllen. |
|
Eingeführt in Windows 8.1. Geben Sie diesen Bindungskontext an, um anzugeben, dass die im STR_FILE_SYS_FIND_DATA-Bindungskontext bereitgestellten Daten verwendet werden sollen, um eine ItemID-Liste im format Windows 7 zu erstellen." |
|
Eingeführt in Windows 7. Geben Sie diesen Bindungskontext an, wenn der Handler im selben Thread wie die Benutzeroberfläche abgerufen wird. Alle speicherintensiven Aktivitäten, z. B. solche mit Datenträger- oder Netzwerkzugriff, sollten vermieden werden. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, wenn Sie einen IPropertySetStorage- oder IPropertyStore-Handler anfordern. Dieser Wert wird mit IShellFolder::BindToObject verwendet. Weitere Informationen finden GPS_BESTEFFORT -Flag. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, wenn Sie einen IPropertySetStorage- oder IPropertyStore-Handler anfordern. Dieser Wert wird mit IShellFolder::BindToObject verwendet. Weitere Informationen finden GPS_DELAYCREATION -Flag. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, wenn Sie einen IPropertySetStorage- oder IPropertyStore-Handler anfordern. Dieser Wert wird mit IShellFolder::BindToObject verwendet. Weitere Informationen finden GPS_FASTPROPERTIESONLY -Flag. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, wenn Sie einen IPropertySetStorage- oder IPropertyStore-Handler anfordern. Dieser Wert wird mit IShellFolder::BindToObject verwendet. Weitere Informationen finden GPS_HANDLERPROPERTIESONLY -Flag. |
|
Eingeführt in Windows 7. Geben Sie diesen Bindungskontext an, wenn Sie einen IPropertySetStorage- oder IPropertyStore-Handler anfordern. Dieser Wert wird mit IShellFolder::BindToObject verwendet. Weitere Informationen finden GPS_NO_OPLOCK -Flag. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, wenn Sie einen IPropertySetStorage- oder IPropertyStore-Handler anfordern. Dieser Wert wird mit IShellFolder::BindToObject verwendet. Weitere Informationen finden GPS_OPENSLOWITEM -Flag. |
|
Windows Nur Vista. Geben Sie diesen Bindungskontext an, um einen Aufruf der IShellFolder::BindToObject-Methode zu verursachen, die die IFilter-Schnittstelle für ein Dateisystemobjekt an fordert, einen Textfilter zurückzuerlangen, wenn kein anderer Filter verfügbar ist. Dieser Wert ist ab 7 nicht Windows definiert. |
|
Windows Nur Vista. Geben Sie diesen Bindungskontext an, um einen Aufruf der IShellFolder::BindToObject-Methode zu verursachen, die die IFilter-Schnittstelle für ein Dateisystemobjekt an fordert, keinen Fallbackfilter zurückzurücken, wenn kein registrierter Filter gefunden werden konnte. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, um das Laden des Verlaufs aus einem Stream für eine interne Navigation zu ermöglichen, wenn die IPersistHistory::LoadHistory-Methode aufgerufen wird. Eine interne Navigation ist eine Navigation innerhalb derselben Ansicht. |
|
Eingeführt in Windows 7. Geben Sie diesen Bindungskontext mit STR_PARSE_PREFER_FOLDER_BROWSING an, wenn der Client möchte, dass die Ordnerhandler von Internet Shell eine IDList für eine gültige URL generieren, wenn kein DAV-Typordner für diese URL erstellt werden kann. Die URL wird nicht als vorhanden überprüft. nur die Syntax wird überprüft und überprüft, ob sie über einen registrierten Protokollhandler verfügt. |
|
Eingeführt in Windows 7. Geben Sie diesen Bindungskontext an, um Implementierungen von IShellFolder::P arseDisplayName und IPersistFolder3::InitializeEx anweisen, speicherintensive Hilfsobjekte zwischenzuspeichern, die über Instanziierungen von Shellelementen hinweg vorhanden sein können, anstatt diese Objekte jedes Mal neu zu erstellen, wenn ein Shellelement erstellt wird. Das zugeordnete Objekt ist ein weiteres Bindungskontextobjekt, das anfänglich leer ist. Dies sollte zu einem separaten Bindungskontextobjekt führen, auf das über IBindCtx::GetObjectParam oder IBindCtx::Register.ObjectParam zugegriffen wird. Ein Aufrufer muss dieses Verhalten durch Angabe dieses Bindungskontextparameters beim Aufrufen von SHCreateItemFromParsingName festlegen. Dadurch optimieren Sie das Verhalten der Bindung an mehrere Analysenamen nacheinander. Die Lebensdauer des Bindungskontextobjekts sollte mehrere Instanzen von Shellelementen und ihre einzelnen Bindungskontexte umfassen. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, damit ungültige Dateinamenzeichen in Dateinamen angezeigt werden können. Standardmäßig lehnt ein Aufruf der IShellFolder::P arseDisplayName-Methode Zeichen ab, die in Dateinamen unzulässig sind. Dieser Bindungskontext ist nur in Verbindung mit dem Bindungskontext STR_FILE_SYS_FIND_DATA sinnvoll. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, um einen Aufruf der IShellFolder::P arseDisplayName-Methode im Ordner Desktop zum Analysieren von URLs zu aktivieren. Wenn dieser Bindungskontext angegeben wird, überschreibt er STR_PARSE_PREFER_WEB_BROWSING. |
|
Eingeführt in Windows 7. Geben Sie diesen Bindungskontext an, um die Implementierung von IShellFolder::P arseDisplayName einer Datenquelle anweisen, das Verhalten von SHCreateItemFromParsingName zu optimieren. Normalerweise führt SHCreateItemFromParsingName zwei Bindungsvorgänge für den zu analysierenden Namen aus: eine bis und eine für IShellFolder::P arseDisplayName und eine zum Erstellen des Shellelements. Wenn der STR_PARSE_AND_CREATE_ITEM-Bindungskontext unterstützt wird, wird die zweite Bindung vermieden, indem das Shellelement während der IShellFolder::P arseDisplayName-Bindung erstellt und das Shellelement über IParseAndCreateItem::SetItem gespeichert wird. SHCreateItemFromParsingName verwendet dann das gespeicherte Shellelement, anstatt eines zu erstellen. Dieser Parameter gilt für das letzte Element des namens, der analysiert wird. Im Namen "C:\Folder1\File.txt gelten die Daten beispielsweise für File.txt. |
|
Windows Nur Vista. Geben Sie an, dass dieser Bindungskontext beim Analyse einer URL nicht vor dem Generieren einer IDList vorhanden sein darf. Geben Sie diesen Bindungskontext zusammen mit STR_PARSE_PREFER_FOLDER_BROWSING an, wenn der Client möchte, dass die Ordnerhandler von Internet Shell eine IDList für die URL generieren, wenn kein DAV-Ordner für die gegebene URL erstellt werden kann. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, um das ursprüngliche Element zu übergeben, das neu analysiert wird, wenn dieses Element als IShellItem-Objekt gespeichert wird, das auch die IParentAndItem-Schnittstelle implementiert. Vor Windows 7 wurde dieser Wert nicht in einer Headerdatei definiert. Sie kann vom Aufrufer definiert oder als Zeichenfolgenwert von L"ParseOriginalItem" übergeben werden. Ab Windows 7 wird der Wert in Shlobj.h definiert. Beachten Sie, dass dies ein anderer Header als die anderen STR-Konstanten ist. |
|
Eingeführt in Windows XP. Geben Sie diesen Bindungskontext an, um einen Aufruf der IShellFolder::P arseDisplayName-Methode im Ordner Desktop zu aktivieren, um URLs so zu analysieren, als ob es sich um Ordner wäre. Verwenden Sie diesen Bindungskontext, um eine Bindung an einen WebDAV-Server herzustellen. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, um einen Aufruf der IShellFolder::P arseDisplayName-Methode in den Analyse-URLs des Desktop-Ordnerformulars zu verhindern. Dieser Bindungskontext kann von der -STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, um den von der IShellFolder::P arseDisplayName-Methode verwendeten Standardeigenschaftsspeicher zu überschreiben, und verwenden Sie stattdessen den als bind-Parameter angegebenen Eigenschaftenspeicher. Gilt für Delegatordner. |
|
Eingeführt in Windows XP SP2. Geben Sie diesen Bindungskontext an, um einen Aufruf der IShellFolder::P arseDisplayName-Methode im Ordner Desktop zu aktivieren, um die Präfix notation "shell:" für den Zugriff auf Dateien zu verwenden. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, um einen Aufruf der IShellFolder::P arseDisplayName-Methode zu verursachen, um das Dialogfeld für die Netzwerkdiagnose anzuzeigen, wenn die Analyse eines Netzwerkpfads fehlschlägt. |
|
Eingeführt in Windows Vista. Geben Sie diesen Bindungskontext an, um einen Aufruf der IShellFolder::P arseDisplayName-Methode zu verursachen, um die Überprüfung des Caches der Netzwerkfreigaben zu überspringen und den Netzwerkserver direkt zu kontaktieren. Informationen zu Netzwerkfreigaben werden zur Verbesserung der Leistung zwischengespeichert, und IShellFolder::P arseDisplayName überprüft diesen Cache standardmäßig. |
|
Eingeführt in Windows XP. Geben Sie diesen Bindungskontext an, um analysierte Eigenschaften an die IShellFolder::P arseDisplayName-Methode für einen Delegatnamespace zu übergeben. Der Namespace kann die übergebenen Eigenschaften verwenden, anstatt zu versuchen, den Namen selbst zu analysieren. |
|
Windows Nur Vista. Ein Analysebindungskontext, der verwendet wird, um einen Satz von Eigenschaften und den Namen des Elements beim Aufrufen von IShellFolder::P arseDisplayName zu übergeben. Das Objekt im Bindungskontext implementiert IPropertyStore und wird durch Aufrufen von IBindCtx::GetObjectParam abgerufen. DBFolder ist eine Shell-Datenquelle, die Elemente in Suchergebnissen und abfragebasierten Sichten darstellt. DBFolder ruft diese Elemente ab, indem das Suchsystem Windows wird. Elemente in den Suchergebnissen werden über ein Protokollschema identifiziert, z. B. "file:" oder "mapi:". DBFolder stellt das Verhalten für diese Elemente durch Delegieren an Shell-Datenquellen zur Verfügung, die für diese Protokolle erstellt werden. Weitere Informationen finden Sie unter Entwickeln von Protokollhandler-Add-Ins. Wenn DBFolder seinen Analysevorgang an die Shell-Datenquellen delegiert, die Windows Search-Protokolle unterstützen, bietet dieser Bindungskontext Zugriff auf Werte, die im Abfrageergebnis für dieses Element zurückgegeben wurden. Hierzu gehören folgende Elemente:
Dieser Bindungskontext kann auch verwendet werden, um ein DBFolder-Element zu analysieren, wenn ein Client über einen Satz von Eigenschaften verfügt, die das Element definieren. In diesem Fall sollte ein leerer Name an IShellFolder::P arseDisplayName übergeben werden. Vor Windows 7 wurde dieser Wert nicht in einer Headerdatei definiert. Sie kann vom Aufrufer definiert oder als Zeichenfolgenwert übergeben werden: L"ParseWithProperties" . Ab Windows 7 wird der Wert in Shlobj.h definiert. Beachten Sie, dass dies ein anderer Header ist als der, an dem die anderen STR-Konstanten definiert sind. |
|
Eingeführt in Windows 8. Geben Sie diesen Bindungskontext an, um anzugeben, dass es sich bei dem Bindungskontextparameter um eine Eigenschaftentüte (IPropertyBag) handelt, mit der VARIANT-Werte im Bindungskontext übergeben werden. Weitere Informationen finden Sie im Abschnitt "Hinweise". |
|
Eingeführt in Windows XP. Geben Sie diesen Bindungskontext an, um Aufrufe der Methoden IShellFolder::P arseDisplayName oder IShellFolder::BindToObject zu verursachen, um eine bestimmte Shell-Namespaceerweiterung beim Analyse- oder Bindungsing zu ignorieren. Die CLSID des zu ignorierenden Namespace wird von der IPersist::GetClassID-Methode des bind-Parameters bereitgestellt. [!Note] |
|
Wird nicht verwendet. |
Bemerkungen
Bindungskontexte werden verwendet, um optionale Parameter an Funktionen zu übergeben, die über einen IBindCtx-Parameter * verfügen. Diese Parameter werden als COM-Objekte ausgedrückt und implementieren möglicherweise Schnittstellen, die zum Modellieren der Parameterdaten verwendet werden. Einige Bindungskontexte stellen einen booleschen Wert dar, wobei TRUE ein Objekt angibt, das nur IUnknown implementiert, und FALSE gibt an, dass kein Objekt vorhanden ist.
IShellFolder::P arseDisplayName, IShellFolder::BindToObject und IShellItem::BindToHandler verwenden einen Bindungskontext, und Sie können ihnen Parameter über diesen Bindungskontext übergeben.
Einige Bindungskontexte sind spezifisch für bestimmte Datenquellenimplementierungen oder Handlertypen.
Bindungskontextparameter werden für die Verwendung mit einer bestimmten Funktion oder Methode definiert.
Wenn Sie einen Eigenschaftenspeicher über IShellFolderanfordern, können Sie die Entsprechung von GPS _ DEFAULT angeben, indem Sie einen IBindCtx-Nullparameter übergeben. Sie können auch die Entsprechung von GPS READWRITE angeben, indem Sie im Bindungskontext den Modus _ STGM _ READWRITE | STGM _ EXCLUSIVE übergeben.
Die vom STR _ PROPERTYBAG _ PARAM-Bindungskontextobjekt angegebene Eigenschaftentüte enthält zusätzliche Werte, auf die Sie mit den Methoden IPropertyBag::Read und IPropertyBag::Write zugreifen können.
| Eigenschaftenname | type | BESCHREIBUNG |
|---|---|---|
| FLAGS _ FÜR STR-ENUM-ELEMENTE _ _ | VT _ UI4 | Eingeführt in Windows 8. Gibt einen SHCONTF-Wert an, der an IShellFolder::EnumObjects übergeben werden soll, wenn Sie IShellItem::BindToHandler mit DER ID _ EnumItems aufrufen. |
| STR _ PARSE _ EXPLICIT _ ASSOCIATION _ SUCCESSFUL | VT _ BOOL | Eingeführt in Windows 7. Die IShellFolder::P arseDisplayName-Methode legt diese Eigenschaft fest, um den Aufrufer darüber zu informieren, dass die zurückgegebene IDList an die mit STR PARSE WITH EXPLICIT _ _ _ _ PROGID angegebene ProgID oder die mit STR PARSE WITH EXPLICIT _ _ _ _ ASSOCAPP angegebene Anwendung gebunden wurde. Wenn STR PARSE EXPLICIT ASSOCIATION _ _ _ _ SUCCESSFUL nicht vorhanden ist, wurde die ProgID oder Anwendung nicht an idList gebunden. |
| STR _ PARSE _ WITH _ EXPLICIT _ ASSOCAPP | VT _ BSTR | Eingeführt in Windows 7. Geben Sie diese Eigenschaft an, damit ein Aufruf der IShellFolder::P arseDisplayName-Methode eine IDList zurück gibt, die an den Dateityp-Zuordnungshandler für die Anwendung gebunden ist. |
| STR _ PARSE _ WITH _ EXPLICIT _ PROGID | VT _ BSTR | Eingeführt in Windows 7. Geben Sie diese Eigenschaft an, damit ein Aufruf der IShellFolder::P arseDisplayName-Methode eine IDList zurück gibt, die an den Dateiassozhandler der bereitgestellten ProgID gebunden ist. |
Ein Beispiel für die Verwendung von Bindungskontextwerten finden Sie unter Parsing With Parameters Sample (Analyse mit Parametern).
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server 2008 [ R2-Desktop-Apps] |
| Header |
|
| IDL |
|