SetNtmsObjectSecurity-Funktion (ntmsapi.h)

Artikel
08/25/2023

[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]

Die SetNtmsObjectSecurity-Funktion schreibt den Sicherheitsdeskriptor für das angegebene RSM-Objekt.

Syntax

DWORD SetNtmsObjectSecurity(
  [in] HANDLE               hSession,
  [in] LPNTMS_GUID          lpObjectId,
  [in] DWORD                dwType,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR lpSecurityDescriptor
);

Parameter

[in] hSession

Handle für die von der OpenNtmsSession-Funktion zurückgegebene Sitzung.

[in] lpObjectId

Eindeutiger Bezeichner des RSM-Objekts.

[in] dwType

RSM-Objekttyp. Eine Liste der Objekttypen finden Sie unter NtmsObjectsTypes.

[in] SecurityInformation

Ein SECURITY_INFORMATION Wert, der die Sicherheitsinformationen angibt, die in das RSM-Objekt geschrieben werden sollen.

[in] lpSecurityDescriptor

Zeiger auf eine SECURITY_DESCRIPTOR-Struktur , die den Sicherheitsdeskriptor angibt, der in das RSM-Objekt geschrieben werden soll: NTMS_USE_ACCESS, NTMS_CONTROL_ACCESS oder NTMS_MODIFY_ACCESS.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Die zum Ändern des Sicherheitsdeskriptors erforderlichen Berechtigungen werden verweigert.
ERROR_DATABASE_FAILURE	Auf die Datenbank kann nicht zugegriffen werden oder beschädigt werden.
ERROR_DATABASE_FULL	Die Datenbank ist voll.
ERROR_INVALID_HANDLE	Das Sitzungshandle fehlt oder ist ungültig.
ERROR_INVALID_PARAMETER	Die Objekt-ID fehlt.
ERROR_NO_SECURITY_ON_OBJECT	Es gibt keine Sicherheitsinformationen für dieses Objekt.
ERROR_OBJECT_NOT_FOUND	Die Objekt-ID ist ungültig.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Hinweise

Wenn eine Anwendung SetNtmsObjectSecurity verwendet, um die ACL (Discretionary Access Control List) eines Objekts festzulegen, muss die Anwendung über WRITE_DAC Berechtigung verfügen oder der Besitzer des Objekts sein.

Wenn eine Anwendung SetNtmsObjectSecurity zum Festlegen der System-ACL eines Objekts verwendet, muss die SE_SECURITY_NAME-Berechtigung für die Anwendung aktiviert werden. Weitere Informationen finden Sie in der SetPrivateObjectSecurity-Funktion . Weitere Informationen zur RSM-Sicherheit finden Sie unter RSM-Sicherheit.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntmsapi.h
Bibliothek	Ntmsapi.lib
DLL	Ntmsapi.dll

Weitere Informationen

EnumerateNtmsObject

GetNtmsObjectSecurity

Objektverwaltungsfunktionen

Freigeben über