Contents Index Topic Contents | ||
Previous Topic: IShellFolder::GetAttributesOf Next Topic: IShellFolder::GetUIObjectOf |
IShellFolder::GetDisplayNameOf
HRESULT GetDisplayNameOf( LPCITEMIDLIST pidl, DWORD uFlags, LPSTRRET lpName );Retrieves the display name for the specified file object or subfolder, returning it in a STRRET structure.
- Returns NOERROR if successful, or an OLE-defined error value otherwise.
- pidl
- Address of an ITEMIDLIST structure that uniquely identifies the file object or subfolder relative to the parent folder.
- uFlags
- Flags indicating the type of display name to return. For a list of possible values, see the SHGNO enumerated type.
- lpName
- Address of a STRRET structure in which to return the display name. The string returned in this structure depends on the type of display name requested.
If the identifier 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 SHGNO enumerated type.
See also IShellFolder
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.