fs_mapzidtopath

Returns the file system path associated with the zid.

Library:LibC
Classification:Novell
Service:File System Monitoring

Syntax

  #include <fshooks.h> 
   
  int fs_mapzidtopath (
     zid_t        zid,
     volid_t     *volId,
     unicode_t   *path,
     size_t      *maxpathlen,
     int          want_volume );

Parameters

zid

(IN) Specifies the zid of the file object. A zid uniquely identifies a file within a given volume.

volId

(IN) Points to volume ID of the volume associated with the zid.

path

(OUT) Points to the file system path. If NULL is passed, the system allocates a buffer of the required size.

maxpathlen

(IN) Points to the size of the path buffer.

want_volume

(IN) Specifies whether the volume name is included in the path.

Return Values

If successful, returns 0. Otherwise, returns a nonzero error code.

Remarks

A number of the event structures return the zid and volId of the object that was effected by the event. The fs_mapzidtopath function allows you to retrieve the file system path associated with the zid and its associated volId.

See Also