struktur SHARE_INFO_502 (lmshare.h)

Artikel
03/14/2023

Berisi informasi tentang sumber daya bersama, termasuk nama sumber daya, jenis dan izin, jumlah koneksi, dan informasi terkait lainnya.

Sintaks

typedef struct _SHARE_INFO_502 {
  LMSTR                shi502_netname;
  DWORD                shi502_type;
  LMSTR                shi502_remark;
  DWORD                shi502_permissions;
  DWORD                shi502_max_uses;
  DWORD                shi502_current_uses;
  LMSTR                shi502_path;
  LMSTR                shi502_passwd;
  DWORD                shi502_reserved;
  PSECURITY_DESCRIPTOR shi502_security_descriptor;
} SHARE_INFO_502, *PSHARE_INFO_502, *LPSHARE_INFO_502;

Anggota

shi502_netname

Arahkan ke string Unicode yang menentukan nama sumber daya bersama. Panggilan ke fungsi NetShareSetInfo mengabaikan anggota ini.

shi502_type

Kombinasi nilai yang menentukan jenis berbagi. 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 antarproseksi (IPC).

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

Nilai	Makna
STYPE_SPECIAL	Berbagi khusus yang dicadangkan untuk komunikasi antarproseksi (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	Bagian sementara.

shi502_remark

Arahkan ke string Unicode yang menentukan komentar opsional tentang sumber daya bersama.

shi502_permissions

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

Perhatikan bahwa Windows tidak mendukung keamanan tingkat berbagi. Untuk informasi selengkapnya tentang mengontrol akses ke objek yang dapat diamankan, lihat Access Control, Hak Istimewa, dan Objek Yang Dapat Diamankan.

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.

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

shi502_current_uses

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

shi502_path

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

shi502_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. Perhatikan bahwa Windows tidak mendukung keamanan tingkat berbagi.

Anggota ini tidak boleh lebih dari SHPWLEN+1 byte (termasuk karakter null yang mengakhiri). Panggilan ke fungsi NetShareSetInfo mengabaikan anggota ini.

shi502_reserved

Dipesan; harus nol. Panggilan ke fungsi NetShareSetInfo mengabaikan anggota ini.

shi502_security_descriptor

Menentukan SECURITY_DESCRIPTOR yang terkait dengan berbagi ini.

Persyaratan

Persyaratan	Nilai
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)