NetWkstaGetInfo 函式 (lmwksta.h)

發行項
08/24/2023

NetWkstaGetInfo函式會傳回工作站設定的相關資訊。

語法

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

參數

[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

接收資料的緩衝區指標。此資料的格式取決於 level 參數的值。此緩衝區是由系統所配置，而且必須使用 NetApiBufferFree 函式釋放。如需詳細資訊，請參閱網路管理功能緩衝區和網路管理功能緩衝區長度。

傳回值

如果函式成功，傳回值會NERR_Success。

如果函式失敗，傳回值可以是下列其中一個錯誤碼。

傳回碼	描述
ERROR_ACCESS_DENIED	使用者無法存取要求的資訊。
ERROR_INVALID_LEVEL	level參數無效。

備註

Windows Server 2003 和 Windows XP： 如果您在執行 Active Directory 的網域控制站上呼叫此函式，則會根據安全性實體物件的 ACL 來允許或拒絕存取。若要啟用匿名存取，使用者 Anonymous 必須是「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 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	lmwksta.h (include Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll