IShellFolder::GetDisplayNameOf

[Now Supported on Windows NT]

Retrieves the display name for the specified file object or subfolder, returning it in a STRRET structure.

HRESULT GetDisplayNameOf(

LPCITEMIDLIST pidl,	// Pointer to an ITEMIDLIST
DWORD uFlags,	// Type of display to return
LPSTRRET lpName	// Pointer to a STRRET structure
);

Parameters

pidl

Pointer to an ITEMIDLIST structure that uniquely identifies the file object or subfolder relative to the parent folder.

uFlags

Value indicating the type of display name to return. For a list of possible values, see the description of the SHGNO enumerated type.

lpName

Pointer to a STRRET structure in which to return the display name. The string returned in this structure depends on the type of display name requested.

Return Values

Returns NOERROR if successful or an OLE-defined error value otherwise.

Remarks

If the ID contains the display name (in the local character set), it returns the offset to the name. If not, it returns a pointer to the display name string (UNICODE) allocated by the task allocator, or it fills in a buffer. The type of string returned depends on the type of display specified. Values identifying different types of display names are contained in the enumeration SHGNO.

See Also

IShellFolder, ITEMIDLIST, STRRET, SHGNO

Software for developers

Delphi Components
.Net Components
Software for Android Developers

More information resources

MegaDetailed.Net
Unix Manual Pages
Delphi Examples

Databases for Amazon shops developers

Amazon Categories Database
Browse Nodes Database