struktur USE_INFO_1 (lmuse.h)

  • Artikel

Struktur USE_INFO_1 berisi informasi tentang koneksi antara perangkat lokal dan sumber daya bersama. Informasi ini mencakup status koneksi dan jenis koneksi.

Sintaks

typedef struct _USE_INFO_1 {
  LMSTR ui1_local;
  LMSTR ui1_remote;
  LMSTR ui1_password;
  DWORD ui1_status;
  DWORD ui1_asg_type;
  DWORD ui1_refcount;
  DWORD ui1_usecount;
} USE_INFO_1, *PUSE_INFO_1, *LPUSE_INFO_1;

Anggota

ui1_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.

ui1_remote

Jenis: LMSTR

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

\\servername\sharename

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

ui1_password

Jenis: LMSTR

Penunjuk ke string yang berisi kata sandi yang diperlukan untuk membuat sesi antara stasiun kerja tertentu dan server.

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

ui1_status

Jenis: DWORD

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

Nilai Makna
USE_OK
 Koneksi valid.
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.

ui1_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 ui1_localadalah NULL. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
USE_DISKDEV
 Perangkat disk.
USE_SPOOLDEV
 Printer yang ditampung.
USE_IPC
 Komunikasi antarproscess (IPC).

ui1_refcount

Jenis: DWORD

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

ui1_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.

Keterangan

Menentukan anggota ui1_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 kata sandi yang ditentukan oleh anggota ui1_password dalam panggilan awal ke fungsi NetUseAdd .

Persyaratan

   
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