NetSessionGetInfo 函式 (lmshare.h)

擷取特定伺服器與工作站之間建立之會話的相關資訊。

語法

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

參數

[in] servername

字串的指標，指定函式執行所在遠端伺服器的 DNS 或 NetBIOS 名稱。 如果此參數為 Null，則會使用本機電腦。

[in] UncClientName

字串的指標，指定要傳回信息的電腦會話名稱。 這個參數是必要的，而且不能是 Null。 如需詳細資訊，請參閱 NetSessionEnum。

[in] username

字串的指標，指定要傳回其會話資訊的使用者名稱。 這個參數是必要的，而且不能是 Null。

[in] level

指定資料的資訊層級。 此參數可以是下列其中一個值。

[out] bufptr

接收資料的緩衝區指標。 此資料的格式取決於 level 參數的值。 如需詳細資訊，請參閱 網路管理功能緩衝區 和 網路管理功能緩衝區長度。

此緩衝區是由系統所配置，而且必須使用 NetApiBufferFree 函式釋放。

傳回值

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

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

備註

只有系統管理員或伺服器操作員本機群組的成員才能在層級 1 或層級 2 成功執行 NetSessionGetInfo 函式。 層級 0 或層級 10 呼叫不需要特殊群組成員資格。

如果您是針對 Active Directory 進行程式設計，您可以呼叫特定 Active Directory 服務介面 (ADSI) 方法來達成相同的功能，方法是呼叫網路管理會話函式。 如需詳細資訊，請參閱 IADsSession 和 IADsFileServiceOperations。

如果您在成員伺服器或工作站上的資訊層級 1 或 2 呼叫此函式，則所有已驗證的使用者都可以檢視資訊。

範例

下列程式碼範例示範如何使用 對 NetSessionGetInfo 函式的呼叫來擷取會話的相關資訊。 此範例會呼叫 NetSessionGetInfo，並指定資訊層級 10 ( SESSION_INFO_10) 。 如果呼叫成功，程式碼會列印會話的相關資訊。 最後，此範例會釋放配置給資訊緩衝區的記憶體。

#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 = 10;
   LPSESSION_INFO_10 pBuf = NULL;
   LPTSTR pszServerName = NULL;
   LPTSTR pszUNCClientName = NULL;
   LPTSTR pszUserName = NULL;
   NET_API_STATUS nStatus;
   //
   // Check command line arguments.
   //
   if (argc == 3)
   {
      pszUNCClientName = argv[1];
      pszUserName = argv[2];
   }
   else if (argc == 4)
   {
      pszServerName = argv[1];
      pszUNCClientName = argv[2];
      pszUserName = argv[3];
   }
   else
   {
      wprintf(L"Usage: %s [\\\\ServerName] \\\\ClientName UserName\n", argv[0]);
      exit(1);
   }
   //
   // Call the NetSessionGetInfo function, specifying level 10.
   //
   nStatus = NetSessionGetInfo(pszServerName,
                               pszUNCClientName,
                               pszUserName,
                               dwLevel,
                               (LPBYTE *)&pBuf);
   //
   // If the call succeeds,
   //
   if (nStatus == NERR_Success)
   {
      if (pBuf != NULL)
      {
         //
         // Print the session information. 
         //
         wprintf(L"\n\tClient: %s\n", pBuf->sesi10_cname);
         wprintf(L"\tUser:   %s\n", pBuf->sesi10_username);
         printf("\tActive: %d\n", pBuf->sesi10_time);
         printf("\tIdle:   %d\n", pBuf->sesi10_idle_time);
      }
   }
   //
   // Otherwise, indicate a system error.
   //
   else
      fprintf(stderr, "A system error has occurred: %d\n", nStatus);
   //
   // Free the allocated memory.
   //
   if (pBuf != NULL)
      NetApiBufferFree(pBuf);

   return 0;
}

需求

另請參閱

NetSessionDel

NetSessionEnum

網路管理功能

網路管理概觀

SESSION_INFO_0

SESSION_INFO_1

SESSION_INFO_10

SESSION_INFO_2

會話函式