NXFreePathContext

Frees a previously allocated path context.

Library:LibC
Classification:NKS
Service:File and Directory I/O

Syntax

  #include <nks/dirio.h> 
  
  int NXFreePathContext (
     NXPathCtx_t   pathCtx); 
  

Parameters

pathCtx

(IN) Specifies the file system path context to free.

Return Values

If successful, returns 0. Otherwise, returns the following error code, and the status of the description associated with pathCtx is undefined.

Decimal

Hex

Constant

Description

4

0x04

NX_EBADF

Invalid path context.

105

0x69

NX_ENOCONTEXT

The calling thread has no NKS context.

Remarks

The NXFreePathContext function dismantles the system-maintained state information associated with the passed-in path context, and frees any resources that may be allocated for the purpose of maintaining such information.

Path contexts are useful in creating and opening files and directories as well as searching directories.

See Also

NXCreatePathContext