SHBindToFolderIDListParent function
Given a Shell namespace item specified in the form of a folder, and an item identifier list relative to that folder, this function binds to the parent of the namespace item and optionally returns a pointer to the final component of the item identifier list.
Syntax
HRESULT SHBindToFolderIDListParent(
_In_opt_ IShellFolder *psfRoot,
_In_ PCUIDLIST_RELATIVE pidl,
_In_ REFIID riid,
_Out_ void **ppv,
_Out_opt_ PCUITEMID_CHILD *ppidlLast
);
Parameters
- psfRoot [in, optional]
-
Type: IShellFolder*
A pointer to a Shell folder object. If psfRoot is NULL, indicates that the IDList passed is relative to the desktop.
- pidl [in]
-
Type: PCUIDLIST_RELATIVE
A PIDL to bind to, relative to psfRoot. If psfRoot is NULL, this is an absolute IDList relative to the desktop folder.
- riid [in]
-
Type: REFIID
Reference to the desired interface ID. This is typically IID_IShellFolder or IID_IShellFolder2, but can be anything supported by the target folder.
- ppv [out]
-
Type: void**
When this function returns, contains the interface pointer requested in riid. This is typically IShellFolder or IShellFolder2, but can be anything supported by the target folder.
- ppidlLast [out, optional]
-
Type: PCUITEMID_CHILD*
A pointer to the last ID of the pidl parameter, and is a child ID relative to the parent folder returned in ppv. This value can be NULL.
Return value
Type: HRESULT
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
Requirements
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
DLL |
|
See also