Fungsi NetWkstaUserSetInfo (lmwksta.h)

Artikel
03/14/2023

Fungsi NetWkstaUserSetInfo mengatur informasi khusus pengguna tentang elemen konfigurasi untuk stasiun kerja.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetWkstaUserSetInfo(
        LMSTR   reserved,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Parameter

reserved

Parameter ini harus diatur ke nol.

[in] level

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

Nilai	Makna
1	Menentukan informasi tentang stasiun kerja, termasuk nama pengguna saat ini dan domain yang diakses oleh stasiun kerja. Parameter buf menunjuk ke struktur WKSTA_USER_INFO_1 .
1101	Menentukan domain yang dijelajahi oleh stasiun kerja. Parameter buf menunjuk ke struktur WKSTA_USER_INFO_1101 .

[in] buf

Penunjuk ke buffer yang menentukan data. Format data ini tergantung pada nilai parameter tingkat . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan.

[out] parm_err

Penunjuk ke nilai yang menerima indeks parameter pertama yang menyebabkan kesalahan ERROR_INVALID_PARAMETER. Jika parameter ini NULL, indeks tidak dikembalikan pada kesalahan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

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

Menampilkan kode	Deskripsi
ERROR_INVALID_LEVEL	Parameter tingkat tidak valid.
ERROR_INVALID_PARAMETER	Salah satu parameter fungsi tidak valid.

Keterangan

Fungsi NetWkstaUserSetInfo hanya berfungsi secara lokal. Keanggotaan grup administrator diperlukan.

Nama domain di anggota wkui1101_oth_domains struktur WKSTA_USER_INFO_1101 dipisahkan oleh spasi. Daftar kosong valid. Penunjuk NULL berarti membiarkan anggota tidak dimodifikasi. Anggota wkui1101_oth_domains tidak dapat diatur dengan MS-DOS. Saat mengatur elemen ini, NetWkstaUserSetInfo menolak permintaan jika daftar nama tidak valid atau jika nama tidak dapat ditambahkan ke satu atau beberapa adaptor jaringan yang dikelola oleh sistem.

Jika fungsi NetWkstaUserSetInfo mengembalikan ERROR_INVALID_PARAMETER, Anda dapat menggunakan parameter parm_err untuk menunjukkan anggota struktur informasi pengguna stasiun kerja yang tidak valid. (Struktur informasi pengguna stasiun kerja dimulai dengan WKSTA_USER_INFO_ dan formatnya ditentukan oleh parameter tingkat .) Tabel berikut mencantumkan nilai yang dapat dikembalikan dalam parameter parm_err dan anggota struktur terkait yang dalam kesalahan. (Awalan wkui*_ menunjukkan bahwa anggota dapat dimulai dengan beberapa awalan, misalnya, wkui0_ atau wkui1_.)

Nilai	Anggota
WKSTA_OTH_DOMAINS_PARMNUM	wkui*_oth_domains

Contoh

Sampel kode berikut menunjukkan cara mengatur informasi khusus pengguna untuk stasiun kerja menggunakan panggilan ke fungsi NetWkstaUserSetInfo , menentukan tingkat informasi 1101 ( WKSTA_USER_INFO_1101).

#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 = 1101;
   WKSTA_USER_INFO_1101 wui;
   NET_API_STATUS nStatus;

   if (argc != 2)
   {
      fwprintf(stderr, L"Usage: %s OtherDomains\n", argv[0]);
      exit(1);
   }
   //
   // Fill in the WKSTA_USER_INFO_1101 structure member.
   //
   wui.wkui1101_oth_domains = argv[1];
   //
   // Call the NetWkstaUserSetInfo function
   //  to change the list of domains browsed by
   //  the workstation; specify level 1101.
   //
   nStatus = NetWkstaUserSetInfo(NULL,
                                 dwLevel,
                                 (LPBYTE)&wui,
                                 NULL);
   //
   // Display the result of the call.
   //
   if (nStatus == NERR_Success)
      fprintf(stderr, "Workstation user information has been changed\n");
   else
      fprintf(stderr, "A system error has occurred: %d\n", nStatus);

   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