共用方式為


NetWkstaGetInfo 函式 (lmwksta.h)

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

另請參閱

NetWkstaSetInfo

網路管理功能

網路管理概觀

WKSTA_INFO_100

WKSTA_INFO_101

WKSTA_INFO_102

工作站和工作站使用者函式