Metode SetShareInfo dari kelas Win32_Share

Artikel
06/12/2023

Metode kelas SetShareInfoWMI menetapkan parameter sumber daya bersama.

Topik ini menggunakan sintaks Managed Object Format (MOF). Untuk informasi selengkapnya tentang menggunakan metode ini, lihat Memanggil Metode.

Sintaks

uint32 SetShareInfo(
  [in, optional] uint32                   MaximumAllowed,
  [in, optional] string                   Description,
  [in, optional] Win32_SecurityDescriptor Access
);

Parameter

MaximumAllowed [in, opsional]

Batasi jumlah maksimum pengguna yang diizinkan untuk menggunakan sumber daya ini secara bersamaan.

Contoh: 10. Parameter ini bersifat opsional.

Deskripsi [in, opsional]

Komentar opsional untuk menjelaskan sumber daya yang dibagikan.

Akses [in, opsional]

Pendeskripsi keamanan untuk izin tingkat pengguna. Deskriptor keamanan berisi informasi tentang kemampuan izin, pemilik, dan akses sumber daya. Untuk informasi selengkapnya, lihat Win32_SecurityDescriptor.

Mengembalikan nilai

Mengembalikan salah satu nilai yang tercantum dalam daftar berikut ini atau nilai lainnya untuk menunjukkan kesalahan.

Sukses (0)
Akses ditolak (2)
Kegagalan tidak diketahui (8)
Nama tidak valid (9)
Tingkat tidak valid (10)
Parameter tidak valid (21)
Berbagi duplikat (22)
Jalur yang dialihkan (23)
Perangkat atau direktori tidak dikenal (24)
Nama bersih tidak ditemukan (25)
Lainnya (26 4294967295)

Keterangan

Metode SetShareInfo adalah metode objek dinamis dan digunakan pada kemunculan kelas ini.

Hanya anggota grup lokal Administrator atau Operator Akun atau yang memiliki keanggotaan grup operator Komunikasi, Cetak, atau Server yang berhasil menjalankan SetShareInfo. Operator cetak hanya dapat mengatur antrean printer. Operator Komunikasi hanya dapat mengatur antrean perangkat komunikasi.

Contoh

Sampel PowerShell berikut memperbarui nama berbagi newShare .

$newShare = Get-WmiObject win32_share | Where-Object {$_.name -eq "newShare"}
[void]$newShare.SetShareInfo($null,"This is my new description",$null)

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Ruang nama	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Lihat juga

Kelas Sistem Operasi
Win32_Share

Bagikan melalui