struktur SHARE_INFO_503 (lmshare.h)

Artikel
03/14/2023

Berisi informasi tentang sumber daya bersama. Ini identik dengan struktur SHARE_INFO_502 , kecuali bahwa struktur tersebut juga berisi nama server.

Sintaks

typedef struct _SHARE_INFO_503 {
  LMSTR                shi503_netname;
  DWORD                shi503_type;
  LMSTR                shi503_remark;
  DWORD                shi503_permissions;
  DWORD                shi503_max_uses;
  DWORD                shi503_current_uses;
  LMSTR                shi503_path;
  LMSTR                shi503_passwd;
  LMSTR                shi503_servername;
  DWORD                shi503_reserved;
  PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503, *PSHARE_INFO_503, *LPSHARE_INFO_503;

Anggota

shi503_netname

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

shi503_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 0x00000000	Disk drive.
STYPE_PRINTQ 0x00000001	Cetak antrean.
STYPE_DEVICE 0x00000002	Perangkat komunikasi.
STYPE_IPC 0x00000003	Komunikasi antarproscess (IPC).

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

Nilai	Makna
STYPE_SPECIAL 0x80000000	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 0x40000000	Pembagian sementara.

shi503_remark

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

shi503_permissions

Menentukan nilai DWORD yang menunjukkan izin sumber daya bersama untuk server yang berjalan dengan keamanan tingkat berbagi. Perhatikan bahwa Windows tidak mendukung keamanan tingkat berbagi. Anggota ini diabaikan pada server yang menjalankan keamanan tingkat pengguna. Untuk informasi selengkapnya tentang mengontrol akses ke objek yang dapat diamankan, lihat Access Control, Hak Istimewa, dan Objek Yang Dapat Diamankan.

Panggilan ke fungsi NetShareSetInfo mengabaikan anggota ini.

Anggota ini bisa menjadi salah satu nilai berikut.

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

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

shi503_current_uses

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

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

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

shi503_servername

Penunjuk ke string yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat sumber daya bersama berada. Nilai "*" menunjukkan tidak ada nama server yang dikonfigurasi.

shi503_reserved

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

shi503_security_descriptor

Menentukan SECURITY_DESCRIPTOR yang terkait dengan berbagi ini.

Keterangan

Server jarak jauh yang ditentukan dalam anggota shi503_servername harus terikat ke protokol transportasi menggunakan fungsi NetServerTransportAddEx . Dalam panggilan ke NetServerTransportAddEx, 2 atau 3 harus ditentukan untuk parameter tingkat , dan nilai SVTI2_SCOPED_NAME harus ditentukan dalam struktur SERVER_TRANSPORT_INFO_2 untuk protokol transportasi.

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)