Bagikan melalui

Fungsi SetNtmsObjectInformation (ntmsapi.h)

[Manajer Penyimpanan yang Dapat Dilepas tidak lagi tersedia pada Windows 7 dan Windows Server 2008 R2.]

Fungsi SetNtmsObjectInformation mengubah struktur informasi objek yang ditentukan.

Sintaks

DWORD SetNtmsObjectInformation(
  [in] HANDLE                   hSession,
  [in] LPNTMS_GUID              lpObjectId,
  [in] LPNTMS_OBJECTINFORMATION lpInfo
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpObjectId

Pengidentifikasi unik objek RSM.

[in] lpInfo

Penunjuk ke struktur NTMS_OBJECTINFORMATION .

Nilai kembali

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai Makna
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS atau NTMS_CONTROL_ACCESS ditolak untuk objek yang sedang ditulis atau tidak ada modifikasi yang diizinkan untuk jenis objek yang ditentukan. Lihat Keterangan.
ERROR_SUCCESS
 Fungsi berhasil.
ERROR_DATABASE_FAILURE
 Database tidak dapat diakses atau rusak.
ERROR_DATABASE_FULL
 Database penuh.
ERROR_INVALID_HANDLE
 Handel sesi hilang atau tidak valid.
ERROR_INVALID_PARAMETER
 ID objek atau struktur informasi hilang, atau ukuran informasi objek atau tipe objek tidak valid.
ERROR_NOT_ENOUGH_MEMORY
 Kegagalan alokasi terjadi selama pemrosesan.
ERROR_OBJECT_NOT_FOUND
 ID objek tidak valid.

Keterangan

Ukuran dan jenis informasi harus diatur sebelum Anda dapat menggunakan SetNtmsObjectInformation.

Semua properti bisa-tulis untuk objek dibaca dari struktur NTMS_OBJECTINFORMATION dan ditulis ke database tanpa memperhatikan operasi tulis apa pun yang telah terjadi antara waktu aplikasi ini disebut fungsi GetNtmsObjectInformation dan fungsi SetNtmsObjectInformation . Karena itu, Anda dapat kehilangan perubahan.

Untuk menghindari hasil yang tidak dapat diprediksi, aplikasi harus memanggil GetNtmsObjectInformation sebelum memanggil SetNtmsObjectInformation. Seperti disebutkan di atas, SetNtmsObjectInformation memperbarui semua anggota yang dapat ditulis, oleh karena itu aplikasi bertanggung jawab untuk memberikan nilai untuk semua anggota yang dapat ditulis.

Berikut ini adalah daftar objek yang memiliki anggota yang dapat diperbarui.

Object Anggota
NTMS_CHANGER szDescription Membutuhkan NTMS_MODIFY_ACCESS ke pustaka.

Windows XP: Tidak diperlukan hak akses.
NTMS_CHANGER_TYPE szDescription Membutuhkan NTMS_MODIFY_ACCESS ke komputer.

Windows XP: Tidak diperlukan hak akses.
NTMS_COMPUTER dwMediaPoolPolicy
 
dwLibRequestFlags
 
dwLibRequestPurgeTime
 
dwOpRequestFlags
 
dwOpRequestPurgeTime
 
szDescription Membutuhkan NTMS_MODIFY_ACCESS ke komputer.

Windows XP: Tidak diperlukan hak akses.
NTMS_DRIVE dwDeferDismountDelay
 
szDescription Membutuhkan NTMS_MODIFY_ACCESS ke pustaka.

Windows XP: Tidak diperlukan hak akses.
NTMS_DRIVE_TYPE szDescription Membutuhkan NTMS_MODIFY_ACCESS ke komputer.

Windows XP: Tidak diperlukan hak akses.
NTMS_IEDOOR MaxOpenSecs
 
szDescription Membutuhkan NTMS_MODIFY_ACCESS ke pustaka.

Windows XP: Tidak diperlukan hak akses.
NTMS_IEPORT MaxExtendSecs
 
szDescription Membutuhkan NTMS_MODIFY_ACCESS ke pustaka.

Windows XP: Tidak diperlukan hak akses.
NTMS_LIBRARY Pemulihan Otomatis
 
dwCleanerUsesRemaining
 
dwFlags
 
InventoryMethod
 
szDescription
 
szName Membutuhkan NTMS_CONTROL_ACCESS ke pustaka.
NTMS_LIBREQUEST szDescription Membutuhkan NTMS_MODIFY_ACCESS ke pustaka.

Windows XP: Tidak diperlukan hak akses.
NTMS_LOGICAL_MEDIA szDescription
 
szName Membutuhkan NTMS_MODIFY_ACCESS ke kumpulan media media logis.

Windows XP: Tidak diperlukan hak akses.
NTMS_MEDIA_POOL AllocationPolicy
 
DeallocationPolicy
 
dwMaxAllocates
 
MediaType
 
szDescription
 
szName Membutuhkan NTMS_MODIFY_ACCESS ke kumpulan media.

Windows XP: Membutuhkan NTMS_CONTROL_ACCESS ke kumpulan media.
NTMS_MEDIA_TYPE szDescription Membutuhkan NTMS_MODIFY_ACCESS ke komputer.

Windows XP: Tidak diperlukan hak akses.
NTMS_OPREQUEST szDescription Membutuhkan NTMS_MODIFY_ACCESS ke komputer.

Windows XP: Tidak diperlukan hak akses.
NTMS_PARTITION szName
 
szDescription Membutuhkan NTMS_MODIFY_ACCESS ke kumpulan media samping.

Windows XP: Membutuhkan NTMS_CONTROL_ACCESS ke kumpulan media samping.
NTMS_PHYSICAL_MEDIA szDescription
 
szName Membutuhkan NTMS_MODIFY_ACCESS ke kumpulan media.

Windows XP: Tidak diperlukan hak akses.
NTMS_STORAGESLOT szDescription Membutuhkan NTMS_MODIFY_ACCESS ke pustaka.

Windows XP: Tidak diperlukan hak akses.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header ntmsapi.h
Pustaka Ntmsapi.lib
DLL Ntmsapi.dll

Lihat juga

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Fungsi Manajemen Objek

  • Last updated on