IShellItemArray::BindToHandler method
Binds to an object by means of the specified handler.
Syntax
HRESULT BindToHandler( [in] IBindCtx *pbc, [in] REFGUID rbhid, [in] REFIID riid, [out] void **ppvOut );
Parameters
- pbc [in]
-
Type: IBindCtx*
A pointer to an IBindCtx interface on a bind context object.
- rbhid [in]
-
Type: REFGUID
One of the following values, defined in Shlguid.h, that determine the handler.
-
Restricts usage to GetUIObjectOf. Use this handler type only for a flat item array, where all items are in the same folder.
-
Introduced in Windows Vista: Gets an IDataObject object for use with an item or an array of items. Use this handler type only for flat data objects or item arrays created by SHCreateShellItemArrayFromDataObject.
-
Introduced in Windows Vista: Gets an IQueryAssociations object for use with an item or an array of items. This only retrieves the association array object for the first item in the IShellItemArray
- riid [in]
-
Type: REFIID
The IID of the object type to retrieve.
- ppvOut [out]
-
Type: void**
When this methods returns, contains the object specified in 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 Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
IDL |
|