struktur USE_INFO_2 (lmuse.h)

  • Artikel

Struktur USE_INFO_2 berisi informasi tentang koneksi antara komputer lokal dan sumber daya bersama, termasuk jenis koneksi, status koneksi, nama pengguna, dan nama domain.

Sintaks

typedef struct _USE_INFO_2 {
  LMSTR ui2_local;
  LMSTR ui2_remote;
  LMSTR ui2_password;
  DWORD ui2_status;
  DWORD ui2_asg_type;
  DWORD ui2_refcount;
  DWORD ui2_usecount;
  LMSTR ui2_username;
  LMSTR ui2_domainname;
} USE_INFO_2, *PUSE_INFO_2, *LPUSE_INFO_2;

Anggota

ui2_local

Jenis: LMSTR

Penunjuk ke string yang berisi nama perangkat lokal (misalnya, drive E atau LPT1) yang dialihkan ke sumber daya bersama. DEVLEN konstanta menentukan jumlah karakter maksimum dalam string. Anggota ini bisa NULL. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

ui2_remote

Jenis: LMSTR

Penunjuk ke string yang berisi nama berbagi sumber daya jarak jauh. String dalam bentuk

\\servername\sharename

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

ui2_password

Jenis: LMSTR

Penunjuk ke string yang berisi kata sandi yang diperlukan untuk membuat sesi dengan stasiun kerja tertentu.

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

ui2_status

Jenis: DWORD

Status koneksi. Elemen ini tidak digunakan oleh fungsi NetUseAdd . Nilai berikut didefinisikan.

Nilai Makna
USE_OK
 Koneksi berhasil.
USE_PAUSED
 Dijeda oleh stasiun kerja lokal.
USE_SESSLOST
 Terputus.
USE_DISCONN
 Terjadi kesalahan.
USE_NETERR
 Terjadi kesalahan jaringan.
USE_CONN
 Koneksi sedang dibuat.
USE_RECONN
 Menyambungkan kembali.

ui2_asg_type

Jenis: DWORD

Jenis sumber daya jarak jauh yang diakses. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai Makna
USE_WILDCARD
 Cocok dengan jenis sumber daya bersama server. Wildcard hanya dapat digunakan dengan fungsi NetUseAdd , dan hanya ketika anggota ui2_local adalah string NULL . Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
USE_DISKDEV
 Perangkat disk.
USE_SPOOLDEV
 Printer yang ditampung.
USE_IPC
 Komunikasi antarproscess (IPC).

ui2_refcount

Jenis: DWORD

Jumlah file, direktori, dan proses lain yang terbuka pada sumber daya jarak jauh. Elemen ini tidak digunakan oleh fungsi NetUseAdd .

ui2_usecount

Jenis: DWORD

Jumlah koneksi eksplisit (pengalihan dengan nama perangkat lokal) atau koneksi UNC implisit (pengalihan tanpa nama perangkat lokal) yang dibuat dengan sumber daya.

ui2_username

Jenis: LPWSTR

Penunjuk ke string yang berisi nama pengguna yang memulai koneksi.

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

ui2_domainname

Jenis: LMSTR

Penunjuk ke string yang berisi nama domain sumber daya jarak jauh.

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

Keterangan

Menentukan anggota ui2_local yaitu NULL meminta autentikasi dengan server tanpa mengalihkan huruf kandar atau perangkat. Pengalihan di masa mendatang yang melibatkan server saat koneksi yang sama berlaku menggunakan informasi autentikasi yang ditentukan dalam panggilan awal ke fungsi NetUseAdd . Informasi ini mencakup kombinasi anggota ui2_password, ui2_username, dan ui2_domainname .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header lmuse.h (termasuk Lm.h)

Lihat juga

NetUseAdd

NetUseEnum

NetUseGetInfo

Gambaran Umum Manajemen Jaringan

Struktur Manajemen Jaringan

Gunakan Fungsi