Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
BindToHandler
Collapse the table of content
Expand the table of content

IShellItem::BindToHandler method

Binds to a handler for an item as specified by the handler ID value (BHID).

Syntax


HRESULT BindToHandler(
   IBindCtx *pbc,
   REFGUID  rbhid,
   REFIID   riid,
   void     **ppvOut
);

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).

rbhid

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 GetAttributesOf 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.

ppvOut

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

Minimum supported client

Windows XP with SP1 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Shobjidl.h

DLL

Shell32.dll (version 5.00 or later)

See also

IShellItem
IShellFolder

 

 

Community Additions

ADD
Show:
© 2015 Microsoft