Jump to content

wpSetRealName

From EDM2
Revision as of 00:23, 3 September 2025 by Martini (talk | contribs) (Created page with "{{DISPLAYTITLE:wpSetRealName}} This instance method sets the physical name of a file-system object. ==Syntax== <PRE> _wpSetRealName(somSelf, pszName) </PRE> ==Parameters== ;''somSelf'' (WPFileSystem *) - input :Pointer to the object on which the method is being invoked. :Points to an object of class WPObject. ;''pszName'' (PSZ) - input :Pointer to a new file name. :This file cannot be fully qualified. ==Returns== ;''rc'' (BOOL) - returns :Success ind...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This instance method sets the physical name of a file-system object.

Syntax

 _wpSetRealName(somSelf, pszName)

Parameters

somSelf (WPFileSystem *) - input
Pointer to the object on which the method is being invoked.
Points to an object of class WPObject.
pszName (PSZ) - input
Pointer to a new file name.
This file cannot be fully qualified.

Returns

rc (BOOL) - returns
Success indicator.
TRUE: Successful completion.
FALSE: Error occurred.

Remarks

In most cases, the file-system object's real name and title are identical. When a title is set that the file system containing the object cannot handle, the real name is different. In this situation, real name is set to be a truncated title. In the case where the real name and the title are different, the title is stored in the file's ".LONGNAME" extended attribute.

Usage

This method can be called at any time in order to set the physical name for a file-system object.

How to Override

This method is generally not overridden.

Related Methods