Fungsi NetWkstaUserGetInfo (lmwksta.h)

Artikel
08/24/2023

Fungsi NetWkstaUserGetInfo mengembalikan informasi tentang pengguna yang saat ini masuk. Fungsi ini harus dipanggil dalam konteks pengguna yang masuk.

Sintaks

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

Parameter

reserved

Parameter ini harus diatur ke NULL.

[in] level

Menentukan tingkat informasi data. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Mengembalikan nama pengguna yang saat ini masuk ke stasiun kerja. Parameter bufptr menunjuk ke struktur WKSTA_USER_INFO_0 .
1	Mengembalikan informasi tentang stasiun kerja, termasuk nama pengguna saat ini dan domain yang diakses oleh stasiun kerja. Parameter bufptr menunjuk ke struktur WKSTA_USER_INFO_1 .
1101	Mengembalikan domain yang dijelajahi oleh stasiun kerja. Parameter bufptr menunjuk ke struktur WKSTA_USER_INFO_1101 .

[out] bufptr

Arahkan ke buffer yang menerima data. Format data ini tergantung pada nilai parameter bufptr . Buffer ini dialokasikan oleh sistem dan harus dikosongkan menggunakan fungsi NetApiBufferFree . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan dan Panjang Buffer Fungsi Manajemen Jaringan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NERR_Success.

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

Menampilkan kode	Deskripsi
ERROR_NOT_ENOUGH_MEMORY	Sistem kehabisan sumber daya memori. Konfigurasi pengelola jaringan salah, atau program berjalan pada sistem dengan memori yang tidak mencukuum.
ERROR_INVALID_LEVEL	Parameter tingkat tidak valid.
ERROR_INVALID_PARAMETER	Salah satu parameter fungsi tidak valid.

Keterangan

Fungsi NetWkstaUserGetInfo hanya berfungsi secara lokal.

Contoh

Sampel kode berikut menunjukkan cara mengambil informasi tentang pengguna yang saat ini masuk menggunakan panggilan ke fungsi NetWkstaUserGetInfo . Sampel memanggil NetWkstaUserGetInfo, menentukan informasi tingkat 1 ( WKSTA_USER_INFO_1). Jika panggilan berhasil, sampel mencetak informasi tentang pengguna yang masuk. Terakhir, sampel membebaskan memori yang dialokasikan untuk buffer informasi.

#ifndef UNICODE
#define UNICODE
#endif
#pragma comment(lib, "netapi32.lib")

#include <stdio.h>
#include <windows.h> 
#include <lm.h>

int wmain(void)
{
   DWORD dwLevel = 1;
   LPWKSTA_USER_INFO_1 pBuf = NULL;
   NET_API_STATUS nStatus;
   //
   // Call the NetWkstaUserGetInfo function;
   //  specify level 1.
   //
   nStatus = NetWkstaUserGetInfo(NULL,
                                 dwLevel,
                                 (LPBYTE *)&pBuf);
   //
   // If the call succeeds, print the information
   //  about the logged-on user.
   //
   if (nStatus == NERR_Success)
   {
      if (pBuf != NULL)
      {
         wprintf(L"\n\tUser:          %s\n", pBuf->wkui1_username);
         wprintf(L"\tDomain:        %s\n", pBuf->wkui1_logon_domain);
         wprintf(L"\tOther Domains: %s\n", pBuf->wkui1_oth_domains);
         wprintf(L"\tLogon Server:  %s\n", pBuf->wkui1_logon_server);
      }
   }
   // Otherwise, print 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;
}

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	lmwksta.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll