Fungsi NetSessionDel (lmshare.h)

Mengakhiri sesi jaringan antara server dan stasiun kerja.

Sintaks

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

Parameter

[in] servername

Penunjuk ke string yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] UncClientName

Penunjuk ke string yang menentukan nama komputer klien yang akan diputuskan sambungannya. Jika parameter UncClientName adalah NULL, maka semua sesi pengguna yang diidentifikasi oleh parameter nama pengguna akan dihapus pada server yang ditentukan oleh parameter nama server . Untuk informasi selengkapnya, lihat NetSessionEnum.

[in] username

Penunjuk ke string yang menentukan nama pengguna yang sesinya akan dihentikan. Jika parameter ini ADALAH NULL, semua sesi pengguna dari klien yang ditentukan oleh parameter UncClientName akan dihentikan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan dapat menjadi salah satu kode kesalahan berikut.

Keterangan

Hanya anggota grup lokal Administrator atau Operator Server yang berhasil menjalankan fungsi NetSessionDel .

Jika Anda memprogram Direktori Aktif, Anda mungkin dapat memanggil metode Antarmuka Layanan Direktori Aktif (ADSI) tertentu untuk mencapai fungsionalitas yang sama yang dapat Anda capai dengan memanggil fungsi sesi manajemen jaringan. Untuk informasi selengkapnya, lihat IADsSession dan IADsFileServiceOperations.

Contoh

Sampel kode berikut menunjukkan cara mengakhiri sesi antara server dan stasiun kerja menggunakan panggilan ke fungsi 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;
}

Persyaratan

Lihat juga

NetSessionEnum

NetSessionGetInfo

Fungsi Manajemen Jaringan

Gambaran Umum Manajemen Jaringan

Fungsi Sesi