NetSessionDel 函数 (lmshare.h)

结束服务器和工作站之间的网络会话。

语法

NET_API_STATUS NET_API_FUNCTION NetSessionDel(
  [in] LMSTR servername,
  [in] LMSTR UncClientName,
  [in] LMSTR username
);

参数

[in] servername

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

[in] UncClientName

指向字符串的指针，该字符串指定要断开连接的客户端的计算机名称。 如果 UncClientName 参数为 NULL，则由 username 参数标识的用户的所有会话都将在 servername 参数指定的服务器上删除。 有关详细信息，请参阅 NetSessionEnum。

[in] username

指向字符串的指针，该字符串指定要终止其会话的用户的名称。 如果此参数为 NULL，则将终止 来自由 UncClientName 参数指定的客户端的所有用户会话。

返回值

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

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

返回代码	说明
ERROR_ACCESS_DENIED	用户无权访问请求的信息。
ERROR_INVALID_PARAMETER	指定的参数无效。
ERROR_NOT_ENOUGH_MEMORY	可用内存不足。
NERR_ClientNameNotFound	不存在具有该计算机名称的会话。

注解

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

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

示例

以下代码示例演示如何使用调用 NetSessionDel 函数终止服务器和工作站之间的会话。

#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 dwError = 0;
   LPTSTR pszServerName = NULL;
   LPTSTR pszClientName = NULL;
   LPTSTR pszUserName = NULL;
   NET_API_STATUS nStatus;
   //
   // Check command line arguments.
   //
   if (argc > 4)
   {
      wprintf(L"Usage: %s [\\\\ServerName] [\\\\ClientName] [UserName]\n", argv[0]);
      exit(1);
   }

   if (argc >= 2)
      pszServerName = argv[1];

   if (argc >= 3)
      pszClientName = argv[2];

   if (argc == 4)
      pszUserName = argv[3];
   //
   // Call the NetSessionDel function to delete the session.
   //
   nStatus = NetSessionDel(pszServerName,
                           pszClientName,
                           pszUserName);
   //
   // Display the result of the call.
   //
   if (nStatus == NERR_Success)
      fprintf(stderr, "The specified session(s) has been successfully deleted\n");
   else
      fprintf(stderr, "A system error has occurred: %d\n", nStatus);

   return 0;
}

要求

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

另请参阅

NetSessionEnum

NetSessionGetInfo

网络管理功能

网络管理概述

会话函数