IShellFolderBindToObject Method

Retrieves a handler, typically the Shell folder object that implements IShellFolder for a particular item.

Optional parameters that control the construction of the handler are passed in the bind context.

Definition

Namespace: DevCase.Win32.Interfaces
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.
Object BindToObject(
	PIDL pidl,
	[OptionalAttribute] IBindCtx pbc,
	ref Guid refIid
)

Parameters

pidl  PIDL
The address of an ITEMIDLIST structure (PIDL) that identifies the subfolder.

This value can refer to an item at any level below the parent folder in the namespace hierarchy.

The structure contains one or more SHITEMID structures, followed by a terminating NULL.

pbc  IBindCtx  (Optional)
A pointer to an IBindCtx interface on a bind context object that can be used to pass parameters to the construction of the handler.

If this parameter is not used, set it to NULL.

Because support for this parameter is optional for folder object implementations, some folders may not support the use of bind contexts.

Information that can be provided in the bind context includes a BIND_OPTS structure that includes a grfMode member that indicates the access mode when binding to a stream handler. Other parameters can be set and discovered using IBindCtx::RegisterObjectParam and IBindCtx::GetObjectParam.

refIid  Guid
The identifier of the interface to return. This may be IID_IShellFolder, IID_IStream, or any other interface that identifies a particular handler.

Return Value

Object
When this method returns, contains the address of a pointer to the requested interface.

If an error occurs, a NULL pointer is returned at this address.

See Also