NetFileGetInfo 函数 (lmshare.h)

项目
08/24/2023

检索有关服务器资源的特定打开的信息。

语法

NET_API_STATUS NET_API_FUNCTION NetFileGetInfo(
  [in]  LMSTR  servername,
  [in]  DWORD  fileid,
  [in]  DWORD  level,
  [out] LPBYTE *bufptr
);

parameters

[in] servername

指向字符串的指针，该字符串指定要在其中执行函数的远程服务器的 DNS 或 NetBIOS 名称。如果此参数为 NULL，则使用本地计算机。

如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ，则此字符串为 Unicode。

[in] fileid

指定要为其返回信息的打开资源的文件标识符。此参数的值必须在以前的枚举调用中返回。有关更多信息，请参见下面的“备注”部分。

[in] level

指定数据的信息级别。此参数的取值可为下列值之一：

值	含义
2	返回文件标识号。 bufptr 参数是指向 FILE_INFO_2 结构的指针。
3	返回文件标识号和有关文件的其他信息。 bufptr 参数是指向FILE_INFO_3结构的指针。

[out] bufptr

指向接收信息的缓冲区地址的指针。此数据的格式取决于级别参数的值。此缓冲区由系统分配，必须使用 NetApiBufferFree 函数释放。有关详细信息，请参阅网络管理功能缓冲区和网络管理功能缓冲区长度。

返回值

如果函数成功，则返回值 NERR_Success。

如果函数失败，则返回值可能是以下错误代码之一。

返回代码	说明
ERROR_ACCESS_DENIED	用户无权访问请求的信息。
ERROR_FILE_NOT_FOUND	找不到该文件。
ERROR_INVALID_LEVEL	为级别参数指定的值无效。
ERROR_NOT_ENOUGH_MEMORY	可用内存不足。
NERR_BufTooSmall	提供的缓冲区太小。

注解

只有管理员或服务器操作员本地组的成员才能成功执行 NetFileGetInfo 函数。

可以调用 NetFileEnum 函数来检索有关在服务器上打开的多个文件的信息。

如果要对 Active Directory 进行编程，则可以调用某些 Active Directory 服务接口 (ADSI) 方法，以实现通过调用 NetFileGetInfo 实现的相同功能。有关详细信息，请参阅 IADsResource 和 IADsFileServiceOperations。

要求


最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	lmshare.h (包括 Lm.h)
Library	Netapi32.lib
DLL	Netapi32.dll