系結內容字串索引鍵

  • 發行項

一組字串索引鍵，與 IBindCtx：：RegisterObjectParam 方法搭配使用，以指定系結內容。

常數 描述
STR_AVOID_DRIVE_RESTRICTION_POLICY
 在 Windows XP SP2 中引進。 指定此系結內容，以允許資料來源的用戶端覆寫隱藏的磁碟機號原則，並啟用對封鎖之磁片磁碟機上資料來源的檢視物件存取權。
與 IShellFolder：：BindToObject 或 IShellItem：：BindToHandler搭配使用。
系統支援系統管理員控制的原則，可隱藏指定的磁碟機號，以封鎖使用者透過 Windows 檔案總管存取這些磁片磁碟機。 當此原則處於作用中狀態時，結果就是檢視使用 IShellFolder：：CreateViewObject 方法建立的物件和其他處理常式會在原則封鎖的磁片磁碟機上呼叫時失敗。
STR_BIND_DELEGATE_CREATE_OBJECT
 在 Windows Vista 中引進。 指定這個系結內容，以造成IShellFolder：：BindToObject方法使用由排序參數指定的物件來建立目標物件;在此情況下，IBindCtx：：RegisterObjectParam呼叫中由 punk參數指定的物件必須實作ICreateObject介面。
與 IShellFolder：：BindToObject 或 IShellItem：：BindToHandler搭配使用。
STR_BIND_FOLDER_ENUM_MODE
 在 Windows 7 中引進。 傳遞至具有FOLDER_ENUM_MODE值的 IShellFolder：:P arseDisplayName，以控制剖析專案的列舉模式。 FOLDER_ENUM_MODE值會透過實作IObjectWithFolderEnumMode的物件，在系結內容中傳遞。
具有不同列舉模式的專案會比較 canonically (SHCIDS_CANONICALONLY) 不同，因為它們會列舉不同的專案集。
如果專案不支援列舉模式 (，因為它不是資料夾，或未提供列舉模式) 則會在預設列舉模式中建立。
STR_BIND_FOLDERS_READ_ONLY
 在 Windows 7 中引進。 傳遞至 IShellFolder：:P arseDisplayName 以及 STR_FILE_SYS_BIND_DATA。 這會強制簡單剖析，同時探查 Desktop.ini 檔案的路徑，以便從中取得當地語系化的名稱字串。 這可避免探查路徑上的資料夾，在此情況下，代表伺服器或共用的資料夾可能需要大量時間和資源。 Desktop.ini 檔案會在某些位置快取，因此它至少會和探查資料夾屬性一樣有效率，然後在該資料夾應該變成隻讀的情況下探查 Desktop.ini。
STR_BIND_FORCE_FOLDER_SHORTCUT_RESOLVE
 在 Windows XP SP2 中引進。 指定此系結內容以強制資料夾快捷方式解析指向其目標的連結。
資料夾快捷方式是指向相同命名空間中另一個資料夾專案的資料夾專案，使用連結 (快捷方式) 來保存目標的 IDList。 連結會解析為追蹤目標，以防目標已移動或重新命名。 例如，Windows XP My Network Places資料夾和 Windows Vista 電腦資料夾可以包含使用 [新增網路位置]精靈所建立的資料夾快捷方式。 為了改善效能， IShellFolder：：BindToObject 方法預設不會解析網路資料夾的連結。
與 IShellFolder：：BindToObject 或 IShellItem：：BindToHandler搭配使用。
STR_DONT_PARSE_RELATIVE
 在 Windows XP 中引進。 指定此系結內容，以防止呼叫Desktop資料夾上的IShellFolder：:P arseDisplayName方法，將相對路徑視為相對於桌面;在這種情況下，指定這個系結內容時剖析會失敗。
STR_DONT_RESOLVE_LINK
 在 Windows Vista 中引進。 指定此系結內容，指示IShellItem不要解析在 IShellItem：：BindToHandler中使用BHID_LinkTargetItem GUID 時取得的連結目標。
STR_FILE_SYS_BIND_DATA
 在 Windows XP 中引進。 指定這個系結內容，以提供檔案中繼資料給 IShellFolder：:P arseDisplayName 方法，這個方法會使用此方法，而不是嘗試擷取實際的檔案中繼資料。 相關聯的物件必須實作 IFileSystemBindData ，也可以選擇性地實作 IFileSystemBindData2。 根據預設， IShellFolder：:P arseDisplayName 方法會驗證檔案是否存在，並使用檔案的實際中繼資料來填入識別碼清單。
STR_FILE_SYS_BIND_DATA_WIN7_FORMAT
 在 Windows 8.1 中引進。 指定此系結內容，以指出 STR_FILE_SYS_BIND_DATA 系結內容中提供的資料應該用來建立 Windows 7 格式的 ItemID 清單。」
STR_GET_ASYNC_HANDLER
 在 Windows 7 中引進。 在與 UI 相同的執行緒上擷取處理常式時，請指定這個系結內容。 應避免任何需要大量記憶體的活動，例如涉及磁片或網路存取的活動。
STR_GPS_BESTEFFORT
 在 Windows Vista 中引進。 要求 IPropertySetStorage 或 IPropertyStore 處理常式時，請指定此系結內容。 此值會與 IShellFolder：：BindToObject搭配使用。 如需詳細資訊，請參閱 GPS_BESTEFFORT 旗標。
STR_GPS_DELAYCREATION
 在 Windows Vista 中引進。 要求 IPropertySetStorage 或 IPropertyStore 處理常式時，請指定此系結內容。 此值會與 IShellFolder：：BindToObject搭配使用。 如需詳細資訊，請參閱 GPS_DELAYCREATION 旗標。
STR_GPS_FASTPROPERTIESONLY
 在 Windows Vista 中引進。 要求 IPropertySetStorage 或 IPropertyStore 處理常式時，請指定此系結內容。 此值會與 IShellFolder：：BindToObject搭配使用。 如需詳細資訊 ，請參閱GPS_FASTPROPERTIESONLY 旗標。
STR_GPS_HANDLERPROPERTIESONLY
 在 Windows Vista 中引進。 要求 IPropertySetStorage 或 IPropertyStore 處理常式時，請指定此系結內容。 此值會與 IShellFolder：：BindToObject搭配使用。 如需詳細資訊 ，請參閱GPS_HANDLERPROPERTIESONLY 旗標。
STR_GPS_NO_OPLOCK
 在 Windows 7 中引進。 要求 IPropertySetStorage 或 IPropertyStore 處理常式時，請指定此系結內容。 此值會與 IShellFolder：：BindToObject搭配使用。 如需詳細資訊 ，請參閱GPS_NO_OPLOCK 旗標。
STR_GPS_OPENSLOWITEM
 在 Windows Vista 中引進。 要求 IPropertySetStorage 或 IPropertyStore 處理常式時，請指定此系結內容。 此值會與 IShellFolder：：BindToObject搭配使用。 如需詳細資訊，請參閱 GPS_OPENSLOWITEM 旗標。
STR_IFILTER_FORCE_TEXT_FILTER_FALLBACK
 僅限 Windows Vista。 指定這個系結內容，讓呼叫 IShellFolder：：BindToObject 方法，要求檔案系統物件的 IFilter 介面傳回文字篩選準則，如果沒有其他篩選。 此值未定義為 Windows 7。
STR_IFILTER_LOAD_DEFINED_FILTER
 僅限 Windows Vista。 指定這個系結內容，讓呼叫 IShellFolder：：BindToObject 方法，要求檔案系統物件的 IFilter 介面在找不到已註冊的篩選準則時，不會傳回後援篩選。
STR_INTERNAL_NAVIGATE
 在 Windows Vista 中引進。 指定此系結內容，以在呼叫 IPersistHistory：：LoadHistory 方法時，從資料流程載入歷程記錄。 內部導覽是相同檢視內的導覽。
STR_INTERNETFOLDER_PARSE_ONLY_URLMON_BINDABLE
 在 Windows 7 中引進。 如果無法為該 URL 建立 DAV 類型資料夾，用戶端想要 Internet Shell 資料夾處理常式為任何有效的 URL 產生 IDList，請指定此系結內容與STR_PARSE_PREFER_FOLDER_BROWSING。 URL 未驗證為存在;只會檢查其語法，且其具有已註冊的通訊協定處理常式。
STR_ITEM_CACHE_CONTEXT
 在 Windows 7 中引進。 指定此系結內容以指示 IShellFolder：:P arseDisplayName 和 IPersistFolder3：：InitializeEx 的實作，以快取可在 Shell 專案具現化中存在的記憶體密集協助程式物件，而不是每次建立 Shell 專案時重新建立這些物件。 相關聯的物件是另一個系結內容物件，一開始是空的。 這應該會產生個別的系結內容物件，這是透過 IBindCtx：：GetObjectParam 或 IBindCtx：：Register.ObjectParam存取。
呼叫端必須在呼叫 SHCreateItemFromParsingName時提供此系結內容參數來加入宣告此行為。 如此一來，您就可以連續將系結至多個剖析名稱的行為優化。 系結內容物件的存留期應該跨越殼層專案的多個實例及其個別系結內容。
STR_NO_VALIDATE_FILENAME_CHARS
 在 Windows Vista 中引進。 指定此系結內容，以允許檔案名中出現不正確檔案名字元。 根據預設， IShellFolder：:P arseDisplayName 方法的呼叫會拒絕檔案名中不合法的字元。 此系結內容僅與STR_FILE_SYS_BIND_DATA系結內容搭配使用。
STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS
 在 Windows Vista 中引進。 指定此系結內容，以在Desktop資料夾上啟用IShellFolder：:P arseDisplayName方法的呼叫，以剖析 URL。 如果指定此系結內容，則會覆寫 STR_PARSE_PREFER_WEB_BROWSING。
STR_PARSE_AND_CREATE_ITEM
 在 Windows 7 中引進。 指定此系結內容以指示資料來源的 IShellFolder：:P arseDisplayName 實作，以優化 SHCreateItemFromParsingName的行為。
一般而言， SHCreateItemFromParsingName 會對要剖析的名稱執行兩個系結作業：一到 IShellFolder：:P arseDisplayName ，另一個用來建立 Shell 專案。 支援 STR_PARSE_AND_CREATE_ITEM 系結內容時，在 IShellFolder：:P arseDisplayName 系結期間建立 Shell 專案，並透過 IParseAndCreateItem：：SetItem儲存 Shell 專案，以避免第二個系結。 SHCreateItemFromParsingName 接著會使用儲存的 Shell 專案，而不是建立一個專案。
此參數會套用至剖析之名稱的最後一個專案。 例如，在名稱 「C:\Folder1\File.txt，資料會套用至 File.txt。
STR_PARSE_DONT_REQUIRE_VALIDATED_URLS
 僅限 Windows Vista。 指定在剖析 URL 時，此系結內容不應該要求 URL 存在，才能為其產生 IDList。 如果無法為指定的 URL 建立 DAV 資料夾，則指定此系結內容以及 STR_PARSE_PREFER_FOLDER_BROWSING ，當用戶端希望 Internet Shell 資料夾處理常式為 URL 產生 IDList 時。
STR_PARSE_PARTIAL_IDLIST
 在 Windows Vista 中引進。 指定此系結內容，以傳遞當該專案儲存為同時實作IParentAndItem介面的IShellItem物件時，要重新剖析的原始專案。 在 Windows 7 之前，此值未定義于標頭檔中。 呼叫端可以定義它，或當做其字串值 L「ParseOriginalItem」傳遞。 自 Windows 7 起，此值定義于 Shlobj.h 中。 請注意，這是與其他 STR 常數不同的標頭。
STR_PARSE_PREFER_FOLDER_BROWSING
 在 Windows XP 中引進。 指定此系結內容，以在Desktop資料夾上呼叫IShellFolder：:P arseDisplayName方法，以剖析 URL，就像是資料夾一樣。 使用此系結內容來系結至 WebDAV 伺服器。
STR_PARSE_PREFER_WEB_BROWSING
 在 Windows Vista 中引進。 指定此系結內容，以防止呼叫桌面資料夾表單上的IShellFolder：:P arseDisplayName方法剖析 URL。 此系結內容可由 STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS覆寫。
STR_PARSE_PROPERTYSTORE
 在 Windows Vista 中引進。 指定此系結內容以覆寫 IShellFolder：:P arseDisplayName 方法所使用的預設屬性存放區，並改用指定為 bind 參數的屬性存放區。 適用于委派資料夾。
STR_PARSE_SHELL_PROTOCOL_TO_FILE_OBJECTS
 Windows XP SP2 中引進。 指定此系結內容，以啟用對Desktop資料夾上IShellFolder：:P arseDisplayName方法的呼叫，以使用 「shell：」 前置詞標記法來存取檔案。
STR_PARSE_SHOW_NET_DIAGNOSTICS_UI
 在 Windows Vista 中引進。 指定此系結內容，以在網路路徑剖析失敗時呼叫 IShellFolder：:P arseDisplayName 方法，以顯示網路診斷對話方塊。
STR_PARSE_SKIP_NET_CACHE
 在 Windows Vista 中引進。 指定此系結內容以造成 呼叫 IShellFolder：:P arseDisplayName 方法，以略過檢查網路共用快取，並直接連絡網路伺服器。 系統會快取網路共用的相關資訊以改善效能，而 IShellFolder：:P arseDisplayName 預設會檢查此快取。
STR_PARSE_TRANSLATE_ALIASES
 在 Windows XP 中引進。 指定此系結內容，將剖析的屬性傳遞至委派命名空間的 IShellFolder：:P arseDisplayName 方法。 命名空間可以使用傳遞的屬性，而不是嘗試剖析名稱本身。
STR_PARSE_WITH_PROPERTIES
 僅限 Windows Vista。 剖析系結內容，用來在呼叫 IShellFolder：:P arseDisplayName時傳遞一組屬性和專案的名稱。 系結內容中的 物件會實作 IPropertyStore ，並藉由呼叫 IBindCtx：：GetObjectParam來擷取。
DBFolder 是 Shell 資料來源，代表搜尋結果和查詢檢視中的專案。 DBFolder 會藉由查詢 Windows 搜尋系統來擷取這些專案。 搜尋結果中的專案是透過通訊協定配置來識別，例如 「file：」 或 「mapi：」。 DBFolder 藉由委派給針對這些通訊協定建立的 Shell 資料來源，來提供這些專案的行為。 如需詳細資訊，請參閱 開發通訊協定處理常式增益集 。
當 DBFolder 將其剖析作業委派給支援 Windows 搜尋通訊協定的 Shell 資料來源時，此系結內容會提供存取該專案查詢結果中所傳回的值。 其中包括下列項目：

如果用戶端有一組定義專案的屬性，這個系結內容也可以用來剖析 DBFolder 專案。 在此情況下，應該將空的名稱傳遞至 IShellFolder：:P arseDisplayName。
在 Windows 7 之前，未在標頭檔中定義此值。 它可以由呼叫端定義，或當做其字串值傳遞： L"ParseWithProperties" 。 自 Windows 7 起，此值定義于 Shlobj.h 中。 請注意，這是與定義其他 STR 常數不同的標頭。
STR_PROPERTYBAG_PARAM
 在 Windows 8 中引進。 指定此系結內容，指出系結內容參數是屬性包 (IPropertyBag) ，用來在系結內容中傳遞 VARIANT 值。 如需詳細資訊，請參閱一節。
STR_SKIP_BINDING_CLSID
 在 Windows XP 中引進。 指定此系結內容，以在剖析或系結時，導致呼叫 IShellFolder：:P arseDisplayName 或 IShellFolder：：BindToObject 方法忽略特定的 Shell 命名空間延伸模組。 要忽略之命名空間的 CLSID 是由 bind 參數的 IPersist：：GetClassID 方法所提供。
注意： 在 Windows 2000 SP3 中引進，此值是在 Shlobj.h 中定義，直到 Windows XP 移至 Shobjidl.h 為止。
STR_TRACK_CLSID
 未使用。

備註

系結內容可用來將選擇性參數傳遞至具有 IBindCtx* 參數的函式。 這些參數會以 COM 物件表示，而且可能會實作用來建立參數資料的模型介面。 某些系結內容代表布林值，其中 TRUE 表示只實作 IUnknown 和 FALSE 的物件表示沒有物件存在。

IShellFolder：:P arseDisplayName、 IShellFolder：：BindToObject 和 IShellItem：：BindToHandler 接受系結內容，您可以透過該系結內容傳遞參數。

某些系結內容專屬於特定資料來源實作或處理常式類型。

系結內容參數是定義來搭配特定函式或方法使用。

透過IShellFolder要求屬性存放區時，您可以藉由傳入 null IBindCtx參數來指定GPS_DEFAULT的對等專案。 您也可以藉由傳遞STGM_READWRITE模式來指定GPS_READWRITE的對等專案 |系結內容中的STGM_EXCLUSIVE。

STR_PROPERTYBAG_PARAM系結內容物件所指定的屬性包包含您可以使用IPropertyBag：：Read和IPropertyBag：：Write方法存取的其他值。

屬性名稱 類型 Description
STR_ENUM_ITEMS_FLAGS VT_UI4 在 Windows 8 中引進。 指定當您使用BHID_EnumItems呼叫IShellItem：：BindToHandler時，要傳遞至IShellFolder：：EnumObjects的SHCONTF值。
STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL VT_BOOL 在 Windows 7 中引進。 IShellFolder：:P arseDisplayName方法會設定此屬性，告知呼叫端傳回的 IDList 已系結至使用 STR_PARSE_WITH_EXPLICIT_PROGID指定的ProgID，或以STR_PARSE_WITH_EXPLICIT_ASSOCAPP指定的應用程式。 當 STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL 不存在時，ProgID 或應用程式並未系結至 IDList。
STR_PARSE_WITH_EXPLICIT_ASSOCAPP VT_BSTR 在 Windows 7 中引進。 指定這個屬性，讓 呼叫 IShellFolder：:P arseDisplayName 方法傳回系結至應用程式的檔案類型關聯處理常式的 IDList。
STR_PARSE_WITH_EXPLICIT_PROGID VT_BSTR 在 Windows 7 中引進。 指定這個屬性，讓 呼叫 IShellFolder：:P arseDisplayName 方法傳回系結至所提供 ProgID之檔案關聯處理常式的 IDList。

 

如需系結內容值的使用範例，請參閱 範例 。

規格需求

需求 值
最低支援的用戶端
 Windows XP [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 R2 [僅限桌面應用程式]
標頭
Shobjidl.h
Idl
Shobjidl.idl