struktur SHARE_INFO_2 (lmshare.h)

Artikel
08/24/2023

Berisi informasi tentang sumber daya bersama, termasuk nama sumber daya, jenis dan izin, dan jumlah koneksi saat ini. Untuk informasi selengkapnya tentang mengontrol akses ke objek yang dapat diamankan, lihat Access Control, Hak Istimewa, dan Objek Yang Dapat Diamankan.

Sintaks

typedef struct _SHARE_INFO_2 {
  LMSTR shi2_netname;
  DWORD shi2_type;
  LMSTR shi2_remark;
  DWORD shi2_permissions;
  DWORD shi2_max_uses;
  DWORD shi2_current_uses;
  LMSTR shi2_path;
  LMSTR shi2_passwd;
} SHARE_INFO_2, *PSHARE_INFO_2, *LPSHARE_INFO_2;

Anggota

shi2_netname

Penunjuk ke string Unicode yang menentukan nama berbagi sumber daya. Panggilan ke fungsi NetShareSetInfo mengabaikan anggota ini.

shi2_type

Kombinasi nilai yang menentukan jenis sumber daya bersama. Panggilan ke fungsi NetShareSetInfo mengabaikan anggota ini.

Salah satu nilai berikut dapat ditentukan. Anda dapat mengisolasi nilai-nilai ini dengan menggunakan nilai STYPE_MASK .

Nilai	Makna
STYPE_DISKTREE	Disk drive.
STYPE_PRINTQ	Cetak antrean.
STYPE_DEVICE	Perangkat komunikasi.
STYPE_IPC	Komunikasi antarproscess (IPC).

Selain itu, salah satu atau kedua nilai berikut dapat ditentukan.

Nilai	Makna
STYPE_SPECIAL	Berbagi khusus disediakan untuk komunikasi antarproscess (IPC$) atau administrasi jarak jauh server (ADMIN$). Dapat juga merujuk ke berbagi administratif seperti C$, D$, E$, dan sebagainya. Untuk informasi selengkapnya, lihat Fungsi Berbagi Jaringan.
STYPE_TEMPORARY	Pembagian sementara.

shi2_remark

Penunjuk ke string Unicode yang berisi komentar opsional tentang sumber daya bersama.

shi2_permissions

Menentukan nilai DWORD yang menunjukkan izin sumber daya bersama untuk server yang berjalan dengan keamanan tingkat berbagi. Server yang menjalankan keamanan tingkat pengguna mengabaikan anggota ini. Anggota ini bisa menjadi satu atau beberapa nilai berikut. Panggilan ke fungsi NetShareSetInfo mengabaikan anggota ini.

Perhatikan bahwa Windows tidak mendukung keamanan tingkat berbagi.

Nilai	Makna
ACCESS_READ	Izin untuk membaca data dari sumber daya dan, secara default, untuk menjalankan sumber daya.
ACCESS_WRITE	Izin untuk menulis data ke sumber daya.
ACCESS_CREATE	Izin untuk membuat instans sumber daya (seperti file); data dapat ditulis ke sumber daya saat sumber daya dibuat.
ACCESS_EXEC	Izin untuk menjalankan sumber daya.
ACCESS_DELETE	Izin untuk menghapus sumber daya.
ACCESS_ATRIB	Izin untuk mengubah atribut sumber daya (seperti tanggal dan waktu saat file terakhir diubah).
ACCESS_PERM	Izin untuk mengubah izin (baca, tulis, buat, jalankan, dan hapus) yang ditetapkan ke sumber daya untuk pengguna atau aplikasi.
ACCESS_ALL	Izin untuk membaca, menulis, membuat, menjalankan, dan menghapus sumber daya, dan untuk mengubah atribut dan izinnya.

shi2_max_uses

Menentukan nilai DWORD yang menunjukkan jumlah maksimum koneksi bersamaan yang dapat diakomodasi oleh sumber daya bersama. Jumlah koneksi tidak terbatas jika nilai yang ditentukan dalam anggota ini adalah –1.

shi2_current_uses

Menentukan nilai DWORD yang menunjukkan jumlah koneksi saat ini ke sumber daya. Panggilan ke fungsi NetShareSetInfo mengabaikan anggota ini.

shi2_path

Penunjuk ke string Unicode yang menentukan jalur lokal untuk sumber daya bersama. Untuk disk, shi2_path adalah jalur yang dibagikan. Untuk antrean cetak, shi2_path adalah nama antrean cetak yang dibagikan. Panggilan ke fungsi NetShareSetInfo mengabaikan anggota ini.

shi2_passwd

Penunjuk ke string Unicode yang menentukan kata sandi berbagi saat server berjalan dengan keamanan tingkat berbagi. Jika server berjalan dengan keamanan tingkat pengguna, anggota ini diabaikan. Anggota shi2_passwd tidak boleh lebih dari SHPWLEN+1 byte (termasuk karakter null yang mengakhiri). Panggilan ke fungsi NetShareSetInfo mengabaikan anggota ini. Perhatikan bahwa Windows tidak mendukung keamanan tingkat berbagi.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	lmshare.h (termasuk Lm.h)

Lihat juga

Gambaran Umum Manajemen Jaringan

Struktur Manajemen Jaringan

Fungsi Berbagi Jaringan