IShellItem::BindToHandler method (shobjidl_core.h)
Binds to a handler for an item as specified by the handler ID value (BHID).
Syntax
HRESULT BindToHandler(
IBindCtx *pbc,
REFGUID bhid,
REFIID riid,
void **ppv
);
Parameters
pbc
Type: IBindCtx*
A pointer to an IBindCtx interface on a bind context object. Used to pass optional parameters to the handler. The contents of the bind context are handler-specific. For example, when binding to BHID_Stream, the STGM flags in the bind context indicate the mode of access desired (read or read/write).
bhid
Type: REFGUID
Reference to a GUID that specifies which handler will be created. One of the following values defined in Shlguid.h:
BHID_SFObject
Restricts usage to BindToObject.
BHID_SFUIObject
Restricts usage to GetUIObjectOf.
BHID_SFViewObject
Restricts usage to CreateViewObject.
BHID_Storage
Attempts to retrieve the storage RIID, but defaults to Shell implementation on failure.
BHID_Stream
Restricts usage to IStream.
BHID_LinkTargetItem
CLSID_ShellItem is initialized with the target of this item (can only be SFGAO_LINK). See SFGAO for a description of SFGAO_LINK.
BHID_StorageEnum
If the item is a folder, gets an IEnumShellItems object with which to enumerate the storage contents.
BHID_Transfer
Introduced in Windows Vista: If the item is a folder, gets an ITransferSource or ITransferDestination object.
BHID_PropertyStore
Introduced in Windows Vista: Restricts usage to IPropertyStore or IPropertyStoreFactory.
BHID_ThumbnailHandler
Introduced in Windows Vista: Restricts usage to IExtractImage or IThumbnailProvider.
BHID_EnumItems
Introduced in Windows Vista: If the item is a folder, gets an IEnumShellItems object that enumerates all items in the folder. This includes folders, nonfolders, and hidden items.
BHID_DataObject
Introduced in Windows Vista: Gets an IDataObject object for use with an item or an array of items.
BHID_AssociationArray
Introduced in Windows Vista: Gets an IQueryAssociations object for use with an item or an array of items.
BHID_Filter
Introduced in Windows Vista: Restricts usage to IFilter.
BHID_EnumAssocHandlers
Introduced in Windows 7: Gets an IEnumAssocHandlers object used to enumerate the recommended association handlers for the given item.
BHID_RandomAccessStream
Introduced in Windows 8: Gets an IRandomAccessStream object for the item.
BHID_FilePlaceholder
Introduced in Windows 8.1: Gets an object used to provide placeholder file functionality.
riid
Type: REFIID
IID of the object type to retrieve.
ppv
Type: void**
When this method returns, contains a pointer of type riid that is returned by the handler specified by rbhid.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP with SP1 [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | shobjidl_core.h (include Shobjidl.h) |
DLL | Shell32.dll (version 5.00 or later) |
See also
Σχόλια
https://aka.ms/ContentUserFeedback.
Σύντομα διαθέσιμα: Καθ' όλη τη διάρκεια του 2024 θα καταργήσουμε σταδιακά τα ζητήματα GitHub ως μηχανισμό ανάδρασης για το περιεχόμενο και θα το αντικαταστήσουμε με ένα νέο σύστημα ανάδρασης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα:Υποβολή και προβολή σχολίων για