Fungsi GetNtmsObjectInformation (ntmsapi.h)

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

Fungsi GetNtmsObjectInformation mengembalikan struktur informasi objek untuk objek yang ditentukan.

Sintaks

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

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpObjectId

Pengidentifikasi unik objek RSM.

[out] lpInfo

Arahkan ke struktur NTMS_OBJECTINFORMATION yang menerima informasi objek.

Nilai kembali

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai	Makna
ERROR_ACCESS_DENIED	NTMS_USE_ACCESS ke objek atau kontainernya ditolak. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan. Windows XP: Tidak diperlukan hak akses.
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.
ERROR_SUCCESS	Fungsi berhasil.

Keterangan

Ukuran informasi dan jenis struktur informasi harus diatur dengan benar dalam parameter lpInfo sebelum Anda menggunakan fungsi GetNtmsObjectInformation .

Untuk menghindari hasil yang tidak dapat diprediksi, aplikasi harus memanggil fungsi GetNtmsObjectInformation sebelum memanggil fungsi SetNtmsObjectInformation . Fungsi SetNtmsObjectInformation memperbarui semua anggota yang dapat ditulis dari struktur NTMS_OBJECTINFORMATION , oleh karena itu aplikasi bertanggung jawab untuk memberikan nilai untuk semua anggota yang dapat ditulis.

Berikut ini adalah daftar objek yang memerlukan hak akses khusus.

Object	Access
NTMS_CHANGER	Membutuhkan NTMS_USE_ACCESS ke pustaka.
NTMS_CHANGER_TYPE	Membutuhkan NTMS_USE_ACCESS ke komputer.
NTMS_COMPUTER	Membutuhkan NTMS_USE_ACCESS ke komputer.
NTMS_DRIVE	Membutuhkan NTMS_USE_ACCESS ke pustaka.
NTMS_DRIVE_TYPE	Membutuhkan NTMS_USE_ACCESS ke komputer.
NTMS_IEDOOR	Membutuhkan NTMS_USE_ACCESS ke pustaka.
NTMS_IEPORT	Membutuhkan NTMS_USE_ACCESS ke pustaka.
NTMS_LIBRARY	Membutuhkan NTMS_USE_ACCESS ke pustaka.
NTMS_LIBREQUEST	Membutuhkan NTMS_USE_ACCESS ke pustaka.
NTMS_LOGICAL_MEDIA	Membutuhkan NTMS_USE_ACCESS ke kumpulan media media logis.
NTMS_MEDIA_TYPE	Membutuhkan NTMS_USE_ACCESS ke komputer.
NTMS_OPREQUEST	Membutuhkan NTMS_USE_ACCESS ke komputer.
NTMS_PARTITION	Membutuhkan NTMS_USE_ACCESS ke kumpulan media samping.
NTMS_PHYSICAL_MEDIA	Membutuhkan NTMS_USE_ACCESS ke kumpulan media.
NTMS_STORAGESLOT	Membutuhkan NTMS_USE_ACCESS ke pustaka.

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

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Fungsi Manajemen Objek

SetNtmsObjectInformation