Membuat metode kelas Win32_Share

Artikel
11/10/2023

Metode Buatkelas WMI memulai berbagi untuk sumber daya server.

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

Sintaks

uint32 Create(
  [in]           string                   Path,
  [in]           string                   Name,
  [in]           uint32                   Type,
  [in, optional] uint32                   MaximumAllowed,
  [in, optional] string                   Description,
  [in, optional] string                   Password,
  [in, optional] Win32_SecurityDescriptor Access
);

Parameter

Jalur [in]

Jalur lokal berbagi Windows.

Contoh, "C:\Program Files".

Nama [dalam]

Meneruskan alias ke jalur yang disiapkan sebagai berbagi pada sistem komputer yang menjalankan Windows.

Contoh, "publik".

Ketik [in]

Meneruskan jenis sumber daya yang dibagikan. Jenis termasuk drive disk, antrean cetak, komunikasi antarproseksi (IPC), dan perangkat umum. Bisa menjadi salah satu nilai berikut.

Disk Drive (0)

Antrean Cetak (1)

Perangkat (2)

IPC (3)

Admin Disk Drive (2147483648)

Admin Antrean Cetak (2147483649)

Admin Perangkat (2147483650)

Admin IPC (2147483651)

MaximumAllowed [in, opsional]

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

Contoh: 10. Parameter ini bersifat opsional.

Deskripsi [dalam, opsional]

Komentar opsional untuk menjelaskan sumber daya yang dibagikan. Parameter ini bersifat opsional.

Kata sandi [dalam, opsional]

Kata sandi (saat server berjalan dengan keamanan tingkat berbagi) untuk sumber daya bersama. Jika server berjalan dengan keamanan tingkat pengguna, parameter ini diabaikan. Parameter ini bersifat opsional.

Access [in, opsional]

Pendeskripsi keamanan untuk izin tingkat pengguna. Deskriptor keamanan berisi informasi tentang kemampuan izin, pemilik, dan akses sumber daya. Jika parameter ini tidak disediakan atau NULL, maka Semua orang memiliki akses baca ke berbagi. Untuk informasi selengkapnya, lihat Win32_SecurityDescriptor dan Mengubah Keamanan Akses pada Objek Yang Dapat Diamankan.

Nilai hasil

Mengembalikan salah satu nilai yang tercantum dalam daftar berikut, atau nilai lainnya untuk menunjukkan kesalahan. Untuk kode kesalahan tambahan, lihat Konstanta Kesalahan WMI atau WbemErrorEnum. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.

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

Buat adalah metode statis.

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

Contoh

Kode PowerShell berikut membuat berbagi.

# create pointer to class
$comp=[WMICLASS]"Win32_share"

# create a new share
$comp.create("c:\","mynewshare",0)

# see results
gwmi win32_share

Sampel kode sebelumnya mengembalikan yang berikut ini:

__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     : 
__DYNASTY        : __PARAMETERS
__RELPATH        : 
__PROPERTY_COUNT : 1
__DERIVATION     : {}
__SERVER         : 
__NAMESPACE      : 
__PATH           : 
ReturnValue      : 2
PSComputerName   : 

Name        : ADMIN$
Path        : C:\Windows
Description : Remote Admin

Name        : C$
Path        : C:\
Description : Default share

Name        : CCMLOGS$
Path        : C:\Windows\CCM\Logs
Description : Public Share

Name        : ccmsetup$
Path        : C:\Windows\ccmsetup
Description : Public Share

Name        : Drop
Path        : C:\Drop
Description : 

Name        : IPC$
Path        : 
Description : Remote IPC

Name        : Share
Path        : C:\Share
Description :

Sampel kode C# berikut menjelaskan cara memanggil metode buat.

private static void makeShare(string servername, string filepath, string sharename)
{
try
 {
 // assemble the string so the scope represents the remote server
 string scope = string.Format("\\\\{0}\\root\\cimv2", servername);

 // connect to WMI on the remote server
 ManagementScope ms = new ManagementScope(scope);

 // create a new instance of the Win32_Share WMI object
 ManagementClass cls = new ManagementClass("Win32_Share");

 // set the scope of the new instance to that created above
 cls.Scope = ms;

 // assemble the arguments to be passed to the Create method
 object[] methodargs = { filepath, sharename, "0" };

 // invoke the Create method to create the share
 object result = cls.InvokeMethod("Create", methodargs);
 }
catch (SystemException e)
 {
  Console.WriteLine("Error attempting to create share {0}:", sharename);
  Console.WriteLine(e.Message);
 }

}

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

Bagikan melalui