Freigeben über

GetNtmsObjectSecurity-Funktion (ntmsapi.h)

[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

  • Last updated on