Fungsi GetNtmsObjectSecurity (ntmsapi.h)

  • Artikel

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

Fungsi GetNtmsObjectSecurity membaca deskriptor keamanan untuk objek RSM yang ditentukan.

Sintaks

DWORD GetNtmsObjectSecurity(
  [in]  HANDLE               hSession,
  [in]  LPNTMS_GUID          lpObjectId,
  [in]  DWORD                dwType,
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR lpSecurityDescriptor,
  [in]  DWORD                nLength,
  [out] LPDWORD              lpnLengthNeeded
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpObjectId

Pengidentifikasi unik objek RSM.

[in] dwType

Jenis objek. Untuk daftar jenis objek, lihat NtmsObjectsTypes.

[in] RequestedInformation

Nilai SECURITY_INFORMATION yang menentukan data keamanan yang diminta.

[out] lpSecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR yang menerima pendeskripsi keamanan.

[in] nLength

Panjang deskriptor.

[out] lpnLengthNeeded

Panjang buffer yang diperlukan jika tidak cukup besar untuk deskriptor keamanan, dalam byte.

Nilai kembali

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai Makna
ERROR_ACCESS_DENIED
 READ_CONTROL akses ke objek ditolak.

Windows XP: Tidak diperlukan hak akses.
ERROR_DATABASE_FAILURE
 Database tidak dapat diakses atau rusak.
ERROR_INVALID_HANDLE
 Handel sesi hilang atau tidak valid.
ERROR_INVALID_PARAMETER
 ID objek hilang.
ERROR_NO_SECURITY_ON_OBJECT
 Tidak ada informasi keamanan untuk objek ini.
ERROR_OBJECT_NOT_FOUND
 ID objek tidak valid.
ERROR_SUCCESS
 Fungsi berhasil.

Keterangan

Keamanan RSM menggunakan deskriptor keamanan standar dan anggota informasi. Ini memungkinkan kotak dialog keamanan standar digunakan untuk memilih keamanan RSM. Untuk informasi selengkapnya, lihat fungsi SetPrivateObjectSecurity . Untuk informasi selengkapnya tentang keamanan RSM, lihat Keamanan RSM.

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

EnumerateNtmsObject

Fungsi Manajemen Objek

SetNtmsObjectSecurity