Sets the attributes of a file or directory.
#include <nks/dirio.h>
int NXSetAttrWithHandle (
NXHandle_t handle,
NXPathFormat_t format,
NXDeLevel_t level,
const void *buffer,
NXChangeBits_t changeBits);
(IN) Specifies a handle to a previously opened file.
(IN) Specifies the pathname format of the file. See NXPathFormat_t Enumeration.
(IN) Specifies the level of information to set (see NXDeLevel_t Enumeration).
(IN) Points to a buffer where information can be found to change for the specific file system object (as defined by the individual platform). This value can be NULL. If a bit in changeBits corresponds to a changeable attribute in the extended entry information, this buffer is expected both to exist and to be long enough to safely satisfy access to changed field. To allow for future platform-specific extensions, the contents are expected to be interpreted in a platform- local file system-dependent manner.
(IN) Specifies the fields that are to change. See Change Bits for Files and Directories.
If successful, returns 0. Otherwise, returns one of the following error codes:
NXSetAttrWithHandle changes the information of the open object identified by the handle. For more information about the levels and the structures, see NXGetAttrWithHandle.
The length of the structure is implicit because the structure is determined by the pathname format of pathCtx and the attribute structures (NXDirAttr_t and others) are fixed length.
The NXSetAttrWithHandle function does not support the NX_DELEVEL_NAME_ONLY flag. Instead, use the NXRename function.