zInfoGetFileName

Returns a namespace-specific filename from the zInfo_s structure.

Service:File System Services (64-Bit)
Version:OES 2

Syntax

#include <zPublics.h>

unicode_t* zInfoGetFileName(
   zInfo_s  *info,
   NINT      nameSpace);

Parameters

info

(IN) Points to the zInfo_s structure, which contains detailed information about the file object.

nameSpace

(IN) Specifies the starting namespace for the path parameter. In addition to the normal namespace identifiers (zNSPACE_DOS | zNSPACE_MAC | zNSPACE_UNIX | zNSPACE_LONG | zNSPACE_DATA_STREAM | zNSPACE_EXTENDED_ATTRIBUTE), the nameSpace parameter can be augmented by ORing the following mode bits:

  • zMODE_UTF8

    The default character set for the path is Unicode; however, by ORing zMODE_UTF8, UTF-8 character strings can be used.

  • zMODE_DELETED

    Changes the name scanning to look for deleted files in the salvage system, which effectively purges the file.

  • zMODE_LINK

    If the last name in the path is a symbolic link, a junction, or a URL link, the scanning does not follow the link but acts on the link object itself.

Return Values

Returns the file string on success or NULL (zero) on failure.

See Also

zGetInfoByName, zModifyInfoByName