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.
Namespace: DevCase.Win32.InterfacesAssembly: 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
)
Function BindToObject (
pidl As PIDL,
<OptionalAttribute> pbc As IBindCtx,
ByRef refIid As Guid
) As Object
Dim instance As IShellFolder
Dim pidl As PIDL
Dim pbc As IBindCtx
Dim refIid As Guid
Dim returnValue As Object
returnValue = instance.BindToObject(pidl,
pbc, refIid)
Object^ BindToObject(
[InAttribute] PIDL^ pidl,
[OptionalAttribute] [InAttribute] IBindCtx^ pbc,
Guid% refIid
)
abstract BindToObject :
pidl : PIDL *
[<OptionalAttribute>] pbc : IBindCtx *
refIid : Guid byref -> Object
No code example is currently available or this language may not be supported.
- 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.
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.