Associa chiavi stringa di contesto

Set di chiavi di stringa usate con il metodo IBindCtx::RegisterObjectParam per specificare un contesto di associazione.

Costante	Descrizione
STR_AVOID_DRIVE_RESTRICTION_POLICY	Introdotta in Windows XP SP2. Specificare questo contesto di associazione per consentire ai client dell'origine dati di eseguire l'override dei criteri di lettera di unità nascosta e abilitare l'accesso agli oggetti di visualizzazione per le origini dati nelle unità bloccate. Usato con IShellFolder::BindToObject o IShellItem::BindToHandler. Il sistema supporta criteri controllati dall'amministratore che nascondono lettere di unità specificate per impedire agli utenti di accedere a tali unità tramite Esplora risorse. Quando questo criterio è attivo, il risultato è che gli oggetti di visualizzazione e altri gestori creati con il metodo IShellFolder::CreateViewObject avranno esito negativo quando viene chiamato nelle unità bloccate dai criteri.
STR_BIND_DELEGATE_CREATE_OBJECT	Introdotto in Windows Vista. Specificare questo contesto di associazione per causare che il metodo IShellFolder::BindToObject usi l'oggetto specificato dal parametro pbc per creare l'oggetto di destinazione; in questo caso, l'oggetto specificato dal parametro punk nella chiamata IBindCtx::RegisterObjectParam deve implementare l'interfaccia ICreateObject . Usato con IShellFolder::BindToObject o IShellItem::BindToHandler.
STR_BIND_FOLDER_ENUM_MODE	Introdotta in Windows 7. Passato a IShellFolder::P arseDisplayName con un valore FOLDER_ENUM_MODE per controllare la modalità di enumerazione dell'elemento analizzato. Il valore FOLDER_ENUM_MODE viene passato nel contesto di associazione tramite un oggetto che implementa IObjectWithFolderEnumMode. Gli elementi con diverse modalità di enumerazione confrontano canonicamente (SHCIDS_CANONICALONLY) diversi perché enumerano diversi set di elementi. Se un elemento non supporta la modalità di enumerazione (perché non è una cartella o non fornisce la modalità di enumerazione), viene creata nella modalità di enumerazione predefinita.
STR_BIND_FOLDERS_READ_ONLY	Introdotta in Windows 7. Passato a IShellFolder::P arseDisplayName insieme a STR_FILE_SYS_BIND_DATA. Questa operazione forza l'analisi semplice mentre si verifica anche per i file di Desktop.ini lungo il percorso da cui ottenere una stringa di nome localizzata. Ciò consente di evitare la verifica delle cartelle lungo il percorso, che, in un caso di cartella che rappresenta un server o una condivisione, potrebbe richiedere tempo e risorse estese. Desktop.ini i file vengono memorizzati nella cache in alcuni percorsi, quindi sarà almeno più efficiente come il probing per gli attributi delle cartelle e quindi la verifica della Desktop.ini se tale cartella deve trasformare ou tot essere di sola lettura.
STR_BIND_FORCE_FOLDER_SHORTCUT_RESOLVE	Introdotta in Windows XP SP2. Specificare questo contesto di associazione per forzare un collegamento di cartella per risolvere il collegamento che punta alla destinazione. Un collegamento alla cartella è un elemento della cartella che punta a un altro elemento della cartella nello stesso spazio dei nomi, usando un collegamento (collegamento) per contenere l'IDList della destinazione. Il collegamento viene risolto per tenere traccia della destinazione nel caso in cui venga spostato o rinominato. Ad esempio, la cartella Windows XP My Network Places e la cartella Computer Windows Vista possono contenere collegamenti di cartella creati con la procedura guidata Aggiungi percorso di rete . Per migliorare le prestazioni, il metodo IShellFolder::BindToObject non risolve i collegamenti alla cartella di rete per impostazione predefinita. Usato con IShellFolder::BindToObject o IShellItem::BindToHandler.
STR_DONT_PARSE_RELATIVE	Introdotto in Windows XP. Specificare questo contesto di associazione per impedire una chiamata al metodo IShellFolder::P arseDisplayName nella cartella Desktop di considerare i percorsi relativi come relativi al desktop; in questo caso, l'analisi ha esito negativo quando viene specificato questo contesto di associazione.
STR_DONT_RESOLVE_LINK	Introdotto in Windows Vista. Specificare questo contesto di associazione per indicare a IShellItem di non risolvere la destinazione del collegamento ottenuta quando si usa il GUID BHID_LinkTargetItem in IShellItem::BindToHandler.
STR_FILE_SYS_BIND_DATA	Introdotto in Windows XP. Specificare questo contesto di associazione per fornire metadati di file al metodo IShellFolder::P ArseDisplayName , usato anziché tentare di recuperare i metadati effettivi del file. L'oggetto associato deve implementare IFileSystemBindData e può anche implementare IFileSystemBindData2. Per impostazione predefinita, il metodo IShellFolder::P arseDisplayName verifica che il file esista e usi i metadati effettivi del file per popolare l'elenco ID.
STR_FILE_SYS_BIND_DATA_WIN7_FORMAT	Introdotta in Windows 8.1. Specificare questo contesto di associazione per indicare che i dati forniti nel contesto di associazione STR_FILE_SYS_BIND_DATA devono essere usati per creare un elenco ItemID nel formato Windows 7."
STR_GET_ASYNC_HANDLER	Introdotta in Windows 7. Specificare questo contesto di associazione quando il gestore viene recuperato nello stesso thread dell'interfaccia utente. Tutte le attività a elevato utilizzo di memoria, ad esempio quelle che coinvolgono l'accesso a disco o di rete, devono essere evitate.
STR_GPS_BESTEFFORT	Introdotto in Windows Vista. Specificare questo contesto di associazione quando si richiede un gestore IPropertySetStorage o IPropertyStore . Questo valore viene usato con IShellFolder::BindToObject. Per altre informazioni, vedere il flag GPS_BESTEFFORT .
STR_GPS_DELAYCREATION	Introdotto in Windows Vista. Specificare questo contesto di associazione quando si richiede un gestore IPropertySetStorage o IPropertyStore . Questo valore viene usato con IShellFolder::BindToObject. Per altre informazioni, vedere il flag GPS_DELAYCREATION .
STR_GPS_FASTPROPERTIESONLY	Introdotto in Windows Vista. Specificare questo contesto di associazione quando si richiede un gestore IPropertySetStorage o IPropertyStore . Questo valore viene usato con IShellFolder::BindToObject. Per altre informazioni, vedere il flag GPS_FASTPROPERTIESONLY .
STR_GPS_HANDLERPROPERTIESONLY	Introdotto in Windows Vista. Specificare questo contesto di associazione quando si richiede un gestore IPropertySetStorage o IPropertyStore . Questo valore viene usato con IShellFolder::BindToObject. Per altre informazioni, vedere il flag GPS_HANDLERPROPERTIESONLY .
STR_GPS_NO_OPLOCK	Introdotta in Windows 7. Specificare questo contesto di associazione quando si richiede un gestore IPropertySetStorage o IPropertyStore . Questo valore viene usato con IShellFolder::BindToObject. Per altre informazioni, vedere il flag GPS_NO_OPLOCK .
STR_GPS_OPENSLOWITEM	Introdotto in Windows Vista. Specificare questo contesto di associazione quando si richiede un gestore IPropertySetStorage o IPropertyStore . Questo valore viene usato con IShellFolder::BindToObject. Per altre informazioni, vedere il flag GPS_OPENSLOWITEM .
STR_IFILTER_FORCE_TEXT_FILTER_FALLBACK	Solo Windows Vista. Specificare questo contesto di associazione per causare una chiamata al metodo IShellFolder::BindToObject che richiede l'interfaccia IFilter per un oggetto file system per restituire un filtro di testo se non è disponibile alcun altro filtro. Questo valore non è definito come windows 7.
STR_IFILTER_LOAD_DEFINED_FILTER	Solo Windows Vista. Specificare questo contesto di associazione per causare una chiamata al metodo IShellFolder::BindToObject che richiede l'interfaccia IFilter per un oggetto file system per non restituire un filtro di fallback se non è stato trovato alcun filtro registrato.
STR_INTERNAL_NAVIGATE	Introdotto in Windows Vista. Specificare questo contesto di associazione per abilitare il caricamento della cronologia da un flusso per uno spostamento interno quando viene chiamato il metodo IPersistHistory::LoadHistory . Uno spostamento interno è uno spostamento all'interno della stessa visualizzazione.
STR_INTERNETFOLDER_PARSE_ONLY_URLMON_BINDABLE	Introdotta in Windows 7. Specificare questo contesto di associazione con STR_PARSE_PREFER_FOLDER_BROWSING quando il client vuole che i gestori di cartelle di Internet Shell generino un IDList per qualsiasi URL valido se non è possibile creare una cartella di tipo DAV per tale URL. L'URL non è verificato; viene verificata solo la sintassi e che ha un gestore del protocollo registrato.
STR_ITEM_CACHE_CONTEXT	Introdotta in Windows 7. Specificare questo contesto di associazione per indicare le implementazioni di IShellFolder::P arseDisplayName e IPersistFolder3::InitializeEx per memorizzare nella cache oggetti helper a elevato utilizzo di memoria che possono esistere tra istanze degli elementi della shell anziché ricreare questi oggetti ogni volta che viene creato un elemento shell. L'oggetto associato è un altro oggetto contesto di associazione, inizialmente vuoto. Ciò dovrebbe comportare un oggetto contesto di associazione separato, accessibile tramite IBindCtx::GetObjectParam o IBindCtx::Register.ObjectParam. Un chiamante deve acconsentire esplicitamente a questo comportamento specificando questo parametro di contesto di associazione quando si chiama SHCreateItemFromParsingName. In questo modo, si ottimizza il comportamento dell'associazione a più nomi di analisi in successione. La durata dell'oggetto contesto di associazione deve estendersi su più istanze di elementi shell e sui singoli contesti di associazione.
STR_NO_VALIDATE_FILENAME_CHARS	Introdotto in Windows Vista. Specificare questo contesto di associazione per consentire la visualizzazione di caratteri di nome file non validi nei nomi di file. Per impostazione predefinita, una chiamata al metodo IShellFolder::P arseDisplayName rifiuta i caratteri non validi nei nomi di file. Questo contesto di associazione è significativo solo in combinazione con il contesto di associazione STR_FILE_SYS_BIND_DATA.
STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS	Introdotto in Windows Vista. Specificare questo contesto di associazione per abilitare una chiamata al metodo IShellFolder::P arseDisplayName nella cartella Desktop per analizzare gli URL. Se viene specificato questo contesto di associazione, esegue l'override di STR_PARSE_PREFER_WEB_BROWSING.
STR_PARSE_AND_CREATE_ITEM	Introdotta in Windows 7. Specificare questo contesto di associazione per indicare all'implementazione di un'origine dati di IShellFolder::P arseDisplayName per ottimizzare il comportamento di SHCreateItemFromParsingName. In genere , SHCreateItemFromParsingName esegue due operazioni di associazione sul nome da analizzare: una e una a IShellFolder::P arseDisplayName e una per creare l'elemento shell. Quando il contesto di associazione STR_PARSE_AND_CREATE_ITEM è supportato, il secondo binding viene evitato creando l'elemento shell durante l'associazione IShellFolder::P arseDisplayName e archiviando l'elemento shell tramite IParseAndCreateItem::SetItem. SHCreateItemFromParsingName usa quindi l'elemento shell archiviato anziché crearne uno. Questo parametro si applica all'ultimo elemento del nome analizzato. Ad esempio, nel nome "C:\Folder1\File.txt, i dati si applicano a File.txt.
STR_PARSE_DONT_REQUIRE_VALIDATED_URLS	Solo Windows Vista. Specificare che, durante l'analisi di un URL, questo contesto di associazione non deve richiedere che l'URL esista prima di generare un IDList. Specificare questo contesto di associazione insieme a STR_PARSE_PREFER_FOLDER_BROWSING quando il client desidera che i gestori di cartelle di Internet Shell generino un IDList per l'URL se non è possibile creare una cartella DAV per l'URL specificato.
STR_PARSE_PARTIAL_IDLIST	Introdotto in Windows Vista. Specificare questo contesto di associazione per passare l'elemento originale da analizzare nuovamente quando tale elemento viene archiviato come oggetto IShellItem che implementa anche l'interfaccia IParentAndItem . Prima di Windows 7 questo valore non è stato definito in un file di intestazione. Può essere definito dal chiamante o passato come valore stringa L"ParseOriginalItem". A partire da Windows 7, il valore è definito in Shlobj.h. Si noti che si tratta di un'intestazione diversa rispetto alle altre costanti STR.
STR_PARSE_PREFER_FOLDER_BROWSING	Introdotta in Windows XP. Specificare questo contesto di associazione per abilitare una chiamata al metodo IShellFolder::P arseDisplayName nella cartella Desktop per analizzare gli URL come se fossero cartelle. Usare questo contesto di associazione per eseguire il binding a un server WebDAV.
STR_PARSE_PREFER_WEB_BROWSING	Introdotto in Windows Vista. Specificare questo contesto di associazione per impedire una chiamata al metodo IShellFolder::P arseDisplayName nella cartella Desktop che analizza gli URL. Questo contesto di associazione può essere sottoposto a override da STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS.
STR_PARSE_PROPERTYSTORE	Introdotto in Windows Vista. Specificare questo contesto di associazione per eseguire l'override dell'archivio delle proprietà predefinito usato dal metodo IShellFolder::P arseDisplayName e usare invece l'archivio delle proprietà specificato come parametro bind. Si applica alle cartelle delegate.
STR_PARSE_SHELL_PROTOCOL_TO_FILE_OBJECTS	Introdotta in Windows XP SP2. Specificare questo contesto di associazione per abilitare una chiamata al metodo IShellFolder::P arseDisplayName nella cartella Desktop per usare la notazione del prefisso "shell:" per accedere ai file.
STR_PARSE_SHOW_NET_DIAGNOSTICS_UI	Introdotto in Windows Vista. Specificare questo contesto di associazione per fare in modo che una chiamata al metodo IShellFolder::P arseDisplayName visualizzi la finestra di dialogo di diagnostica di rete se l'analisi di un percorso di rete non riesce.
STR_PARSE_SKIP_NET_CACHE	Introdotto in Windows Vista. Specificare questo contesto di associazione per fare in modo che una chiamata al metodo IShellFolder::P arseDisplayName ignori di controllare la cache delle condivisioni di rete e contattare direttamente il server di rete. Le informazioni sulle condivisioni di rete vengono memorizzate nella cache per migliorare le prestazioni e IShellFolder::P arseDisplayName controlla questa cache per impostazione predefinita.
STR_PARSE_TRANSLATE_ALIASES	Introdotta in Windows XP. Specificare questo contesto di associazione per passare le proprietà analizzate al metodo IShellFolder::P arseDisplayName per uno spazio dei nomi delegato. Lo spazio dei nomi può usare le proprietà passate anziché tentare di analizzare il nome stesso.
STR_PARSE_WITH_PROPERTIES	Solo Windows Vista. Contesto di associazione di analisi usato per passare un set di proprietà e il nome dell'elemento quando si chiama IShellFolder::P arseDisplayName. L'oggetto nel contesto di associazione implementa IPropertyStore e viene recuperato chiamando IBindCtx::GetObjectParam. DBFolder è un'origine dati shell che rappresenta gli elementi nei risultati della ricerca e nelle viste basate su query. DBFolder recupera questi elementi eseguendo una query sul sistema Windows Search. Gli elementi nei risultati della ricerca vengono identificati tramite uno schema di protocollo, ad esempio "file:" o "mapi:". DBFolder fornisce il comportamento per questi elementi delegando alle origini dati shell create per questi protocolli. Per altre informazioni, vedere Sviluppo di componenti aggiuntivi per gestori di protocolli . Quando DBFolder delega l'operazione di analisi alle origini dati shell che supportano i protocolli di Windows Search, questo contesto di associazione fornisce l'accesso ai valori restituiti nel risultato della query per tale elemento. Il comportamento predefinito include quanto segue: System.ItemType (PKEY_ItemType) System.ParsingPath (PKEY_ParsingPath) System.ItemPathDisplay (PKEY_ItemPathDisplay) System.ItemNameDisplay (PKEY_ItemNameDisplay) Questo contesto di associazione può essere usato anche per analizzare un elemento DBFolder se un client ha un set di proprietà che definiscono l'elemento. In questo caso, è necessario passare un nome vuoto a IShellFolder::P arseDisplayName. Prima di Windows 7, questo valore non è stato definito in un file di intestazione. Può essere definito dal chiamante o passato come valore stringa: L"ParseWithProperties". A partire da Windows 7, il valore è definito in Shlobj.h. Si noti che si tratta di un'intestazione diversa da quella in cui sono definite le altre costanti STR.
STR_PROPERTYBAG_PARAM	Introdotta in Windows 8. Specificare questo contesto di associazione per indicare che il parametro del contesto di associazione è un contenitore delle proprietà (IPropertyBag) usato per passare valori VARIANT nel contesto di associazione. Per altri dettagli, vedere la sezione Osservazioni.
STR_SKIP_BINDING_CLSID	Introdotta in Windows XP. Specificare questo contesto di associazione per fare in modo che le chiamate ai metodi IShellFolder::P arseDisplayName o IShellFolder::BindToObject ignorino una particolare estensione dello spazio dei nomi shell durante l'analisi o l'associazione. Il CLSID dello spazio dei nomi da ignorare viene fornito dal metodo IPersist::GetClassID del parametro bind. Nota: Introdotto in Windows 2000 SP3, questo valore è stato definito in Shlobj.h fino a Windows XP, quando è stato spostato in Shobjidl.h.
STR_TRACK_CLSID	Non usato.

Commenti

I contesti di associazione vengono usati per passare parametri facoltativi alle funzioni con un parametro IBindCtx*. Questi parametri sono espressi come oggetti COM e possono implementare interfacce usate per modellare i dati dei parametri. Alcuni contesti di associazione rappresentano un valore booleano, dove TRUE indica un oggetto che implementa solo IUnknown e FALSE indica che non è presente alcun oggetto.

IShellFolder::P arseDisplayName, IShellFolder::BindToObject e IShellItem::BindToHandler accettano un contesto di associazione ed è possibile passarli tramite tale contesto di associazione.

Alcuni contesti di associazione sono specifici di una determinata implementazione dell'origine dati o dei tipi di gestore.

I parametri di contesto di associazione vengono definiti per l'uso con una funzione o un metodo specifico.

Quando si richiede un archivio di proprietà tramite IShellFolder, è possibile specificare l'equivalente di GPS_DEFAULT passando un parametro IBindCtx null. È anche possibile specificare l'equivalente di GPS_READWRITE passando una modalità di STGM_READWRITE | STGM_EXCLUSIVE nel contesto di associazione.

Il contenitore delle proprietà specificato dall'oggetto contesto di associazione STR_PROPERTYBAG_PARAM contiene valori aggiuntivi a cui è possibile accedere con i metodi IPropertyBag::Read e IPropertyBag::Write .

Nome proprietà	Type	Descrizione
STR_ENUM_ITEMS_FLAGS	VT_UI4	Introdotta in Windows 8. Specifica un valore SHCONTF da passare a IShellFolder::EnumObjects quando si chiama IShellItem::BindToHandler con BHID_EnumItems.
STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL	VT_BOOL	Introdotta in Windows 7. Il metodo IShellFolder::P arseDisplayName imposta questa proprietà per indicare al chiamante che l'IDList restituito è stato associato al ProgID specificato con STR_PARSE_WITH_EXPLICIT_PROGID o l'applicazione specificata con STR_PARSE_WITH_EXPLICIT_ASSOCAPP. Quando STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL è assente, il ProgID o l'applicazione non è stato associato all'IDList.
STR_PARSE_WITH_EXPLICIT_ASSOCAPP	VT_BSTR	Introdotta in Windows 7. Specificare questa proprietà per fare in modo che una chiamata al metodo IShellFolder::P arseDisplayName restituisca un IDList associato al gestore di associazione del tipo di file per l'applicazione.
STR_PARSE_WITH_EXPLICIT_PROGID	VT_BSTR	Introdotta in Windows 7. Specificare questa proprietà per fare in modo che una chiamata al metodo IShellFolder::P arseDisplayName restituisca un IDList associato al gestore dell'associazione file del ProgID specificato.

 

Vedere l'esempio di analisi con parametri per un esempio dell'uso dei valori di contesto di associazione.

Requisiti

Requisito	valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	Shobjidl.h
IDL	Shobjidl.idl