Associa chiavi stringa di contesto
Set di chiavi di stringa usate con il metodo IBindCtx::RegisterObjectParam per specificare un contesto di associazione.
| Costante | Descrizione |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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." |
|
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. |
|
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 . |
|
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 . |
|
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 . |
|
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 . |
|
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 . |
|
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 . |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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:
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. |
|
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. |
|
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 |
|
| IDL |
|