Edit

NetFile Functions (Network Share Management)

  • Article

The network file functions provide a way to monitor and close the file, device, and pipe resources open on a server. The file functions are listed following.

Function Description
NetFileClose Forces a resource to close.
NetFileEnum Returns information about open files on a server.
NetFileGetInfo Returns information about a particular opening of a server resource.

 

Call the NetFileClose function when the file cannot be closed by any other means. This function should be used with caution because NetFileClose does not write data cached on the client system to the file before closing the file.

The NetFileEnum function returns information about resources open on a server. A file can be opened one or more times by one or more applications. Each file opening is uniquely identified. The NetFileEnum function returns an entry for each file opening. The NetFileGetInfo function returns information about one opening of a resource.

File information is available at the following levels.

FILE_INFO_2
FILE_INFO_3

Levels 0 and 1 are not supported. Level 2 returns only the identification number assigned to the resource when it was opened. Level 3 returns the identification number, permissions, file locks, and the name of the user who opened the resource.

If you are programming for Active Directory, you may be able to call certain Active Directory Service Interface (ADSI) methods to achieve the same functionality you can achieve by calling the NetFileEnum and NetFileGetInfo functions. For more information, see IADsResource and IADsFileServiceOperations.