NetFileGetInfo

The NetFileGetInfo function retrieves information about a particular opening of a server resource.

Security Requirements

Only members of the Administrators or Account Operators local group can successfully execute NetFileGetInfo.

NET_API_STATUS NetFileGetInfo(
  LPWSTR servername,  
  DWORD fileid,       
  DWORD level,        
  LPBYTE *bufptr      
);

Parameters

servername
Pointer to a Unicode string containing the name of the remote server on which the function is to execute. A NULL pointer or string specifies the local computer.
fileid
File identifier of the open resource for which to return information. The fileid value must be that returned in a previous enumeration call.
level
Specifies one of the following values to return the level of information pointed to in the bufptr parameter.
Value Meaning
2 Return file identification number. Points to a buffer that contains an array of FILE_INFO_2 structures.
3 Return information about the file. Points to a buffer that contains an array of FILE_INFO_3 structures.

bufptr
Pointer to the address of the return information structure.

Return Values

If the function returns account information, the return value is NERR_Success.

If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_ACCESS_DENIED The user does not have access to the requested information.
ERROR_FILE_NOT_FOUND The file was not found.
ERROR_INVALID_LEVEL The value specified for the Level parameter is invalid.
ERROR_NOT_ENOUGH_MEMORY Insufficient memory is available
NERR_BufTooSmall The supplied buffer is too small.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in lmaccess.h.
  Import Library: Use netapi32.lib.

See Also

Networking (Net) Overview, Net Functions, NetFileEnum