IShellFolderSetNameOf Method

Sets the display name of a file object or subfolder, changing the item identifier in the process.

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.
void SetNameOf(
	IntPtr hwndOwner,
	PIDL pidl,
	string name,
	ShellFoldermGetDisplayName flags,
	ref PIDL refPidlOut
)

Parameters

hwndOwner  IntPtr
A handle to the owner window of any dialog or message box that the client displays.
pidl  PIDL
A pointer to an ITEMIDLIST structure that uniquely identifies the file object or subfolder relative to the parent folder.

The structure must contain exactly one SHITEMID structure followed by a terminating zero.

name  String
A pointer to a null-terminated string that specifies the new display name.
flags  ShellFoldermGetDisplayName
Flags that indicate the type of name specified by the name parameter.
refPidlOut  PIDL
Optional. If specified, the address of a pointer to an ITEMIDLIST structure that receives the ITEMIDLIST of the renamed item.

The caller requests this value by passing a non-null refPidlOut.

Implementations of SetNameOf(IntPtr, PIDL, String, ShellFoldermGetDisplayName, PIDL) must return a pointer to the new ITEMIDLIST in the refPidlOut parameter.

See Also