Bagikan melalui

struktur SHARE_INFO_2 (lmshare.h)

  • Artikel

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

NetShareAdd

NetShareEnum

NetShareGetInfo

NetShareSetInfo

Gambaran Umum Manajemen Jaringan

Struktur Manajemen Jaringan

Fungsi Berbagi Jaringan