GetNtmsObjectSecurity-Funktion (ntmsapi.h)

Artikel
02/29/2024

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

Die GetNtmsObjectSecurity-Funktion liest den Sicherheitsdeskriptor für das angegebene RSM-Objekt.

Syntax

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

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

[in] lpObjectId

Eindeutiger Bezeichner des RSM-Objekts.

[in] dwType

Objekttyp. Eine Liste der Objekttypen finden Sie unter NtmsObjectsTypes.

[in] RequestedInformation

Ein SECURITY_INFORMATION Wert, der die angeforderten Sicherheitsdaten angibt.

[out] lpSecurityDescriptor

Zeiger auf eine SECURITY_DESCRIPTOR-Struktur , die die Sicherheitsbeschreibung empfängt.

[in] nLength

Länge des Deskriptors.

[out] lpnLengthNeeded

Erforderliche Länge des Puffers, wenn er nicht groß genug für die Sicherheitsbeschreibung ist, in Bytes.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	READ_CONTROL Der Zugriff auf das Objekt wird verweigert. Windows XP: Es sind keine Zugriffsrechte erforderlich.
ERROR_DATABASE_FAILURE	Auf die Datenbank kann nicht zugegriffen werden oder ist beschädigt.
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

DIE RSM-Sicherheit verwendet die Standardsicherheitsdeskriptoren und Informationselemente. Dadurch können die Standardmäßigen Sicherheitsdialogfelder verwendet werden, um RSM-Sicherheit auszuwählen. Weitere Informationen finden Sie in der SetPrivateObjectSecurity-Funktion . Weitere Informationen zur RSM-Sicherheit finden Sie unter RSM-Sicherheit.

Anforderungen

Anforderung	Wert
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

Objektverwaltungsfunktionen

SetNtmsObjectSecurity

Freigeben über