NetWkstaGetInfo 函数 (lmwksta.h)

项目
08/24/2023

NetWkstaGetInfo 函数返回有关工作站配置的信息。

语法

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

parameters

[in] servername

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

[in] level

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

值	含义
100	返回有关工作站环境的信息，包括特定于平台的信息、域和本地计算机的名称以及有关操作系统的信息。 bufptr 参数指向WKSTA_INFO_100结构。
101	除了级别 100 信息外，还返回 LANMAN 目录的路径。 bufptr 参数指向WKSTA_INFO_101结构。
102	除了级别 101 信息外，还返回登录到本地计算机的用户数。 bufptr 参数指向WKSTA_INFO_102结构。

[out] bufptr

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

返回值

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

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

返回代码	说明
ERROR_ACCESS_DENIED	用户无权访问请求的信息。
ERROR_INVALID_LEVEL	级别参数无效。

注解

Windows Server 2003 和 Windows XP： 如果在运行 Active Directory 的域控制器上调用此函数，则会根据安全对象的 ACL 允许或拒绝访问。若要启用匿名访问，匿名用户必须是“Windows 2000 之前的兼容访问”组的成员。这是因为匿名令牌默认不包括“每个人”组 SID。如果在成员服务器或工作站上调用此函数，则所有经过身份验证的用户都可以查看信息。如果 EveryoneIncludesAnonymous 策略设置允许匿名访问，则也允许匿名访问。级别 100 始终允许匿名访问。如果在级别 101 中调用此函数，则经过身份验证的用户可以查看信息。管理员以及服务器、系统和打印操作员本地组的成员可以在级别 102 和 502 上查看信息。有关限制匿名访问的详细信息，请参阅网络管理功能的安全要求。有关 ACL、ACE 和访问令牌的详细信息，请参阅访问控制模型。

Windows 2000： 如果在运行 Active Directory 的域控制器上调用此函数，则会根据安全对象的访问控制列表 (ACL) 允许或拒绝访问。默认 ACL 允许所有经过身份验证的用户和“ Windows 2000 之前的兼容访问”组的成员查看信息。默认情况下，“Windows 2000 之前的兼容访问”组将“每个人”作为成员。如果系统允许匿名访问，则允许匿名访问信息。如果在成员服务器或工作站上调用此函数，则所有经过身份验证的用户都可以查看信息。如果 RestrictAnonymous 策略设置允许匿名访问，也允许匿名访问。

若要编译使用此函数的应用程序，请将_WIN32_WINNT宏定义为 0x0400 或更高版本。有关详细信息，请参阅使用 Windows 标头。

示例

以下代码示例演示如何使用调用 NetWkstaGetInfo 函数检索有关工作站的配置元素的信息。此示例调用 NetWkstaGetInfo，将信息级别指定为 102 ( WKSTA_INFO_102) 。如果调用成功，示例将打印有关工作站的信息。最后，代码示例释放为信息缓冲区分配的内存。

#ifndef UNICODE
#define UNICODE
#endif
#pragma comment(lib, "netapi32.lib")

#include <stdio.h>
#include <windows.h> 
#include <lm.h>

int wmain(int argc, wchar_t *argv[])
{
   DWORD dwLevel = 102;
   LPWKSTA_INFO_102 pBuf = NULL;
   NET_API_STATUS nStatus;
   LPWSTR pszServerName = NULL;
   //
   // Check command line arguments.
   //
   if (argc > 2)
   {
      fwprintf(stderr, L"Usage: %s [\\\\ServerName]\n", argv[0]);
      exit(1);
   }
   // The server is not the default local computer.
   //
   if (argc == 2)
      pszServerName = argv[1];
   //
   // Call the NetWkstaGetInfo function, specifying level 102.
   //
   nStatus = NetWkstaGetInfo(pszServerName,
                             dwLevel,
                             (LPBYTE *)&pBuf);
   //
   // If the call is successful,
   //  print the workstation data.
   //
   if (nStatus == NERR_Success)
   {
      printf("\n\tPlatform: %d\n", pBuf->wki102_platform_id);
      wprintf(L"\tName:     %s\n", pBuf->wki102_computername);
      printf("\tVersion:  %d.%d\n", pBuf->wki102_ver_major,
                                  pBuf->wki102_ver_minor);
      wprintf(L"\tDomain:   %s\n", pBuf->wki102_langroup);
      wprintf(L"\tLan Root: %s\n", pBuf->wki102_lanroot);
      wprintf(L"\t# Logged On Users: %d\n", pBuf->wki102_logged_on_users);
   }
   //
   // Otherwise, indicate the system error.
   //
   else
      fprintf(stderr, "A system error has occurred: %d\n", nStatus);
   //
   // Free the allocated memory.
   //
   if (pBuf != NULL)
      NetApiBufferFree(pBuf);

   return 0;
}

要求


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