zModifyInfo

Modifies file status and metadata information for the given file object.

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

Syntax

#include <zPublics.h>

STATUS zModifyInfo(
   Key_t        key,
   Xid_t        xid,
   QUAD         modifyInfoMask,
   NINT         sizeModifyInfo,
   NINT         infoVersion,
   const void  *modifyInfo);

Parameters

key

(IN) Specifies the file (as returned by zOpen or zCreate) whose metadata information will be modified.

xid

(IN) Specifies the transaction to which the request is bound. If there is no transaction, pass zNILXID.

modifyInfoMask

(IN) Specifies a bit mask that identifies which fields of modifyInfoMask are to be modified (see Modify Info Mask Values). If a bit is set in this bit mask, the corresponding field of modifyFileInfo is used to modify the file.

sizeModifyInfo

(IN) Specifies the total size (in bytes) of the zInfo_s structure passed in to modifyInfo, which includes the size of the variable size portion that is used to store any variable sized pieces returned in the structure.

infoVersion

(IN) Specifies the version of the zInfo structure that is being used. For NetWare 6.x versions, there are two supported versions: zINFO_VERSION_A and zINFO_VERSION_B. zINFO_VERSION_B enables the ability to set directory quotas.

modifyInfo

(IN) Is a caller-supplied structure—either zInfo_s or zInfoB_s—that contains the requested information.

Return Values

zOK

The operation completed successfully.

non-0

An error occurred (see Section 4.1, Return Values for a description).

Remarks

Only the metadata corresponding to the bits set in modifyInfoMask is modified. For any fields that are namespace-specific (such as the name), they are modified only in the namespace identified by nameSpace.

If an error occurs, the metadata for the file is not modified.

See Also

zGetInfo, zGetFileMap