RtlCreateSecurityDescriptorRelative Funktion (ntifs.h)
Die RtlCreateSecurityDescriptorRelative-Routine initialisiert einen neuen Sicherheitsdeskriptor im selbstrelativen Format. Bei der Rückgabe wird der Sicherheitsdeskriptor initialisiert, wobei keine System-ACL (SACL), keine diskretionäre ACL (DACL), kein Besitzer, keine primäre Gruppe und alle Steuerelementflags auf Null festgelegt sind.
Syntax
NTSYSAPI NTSTATUS RtlCreateSecurityDescriptorRelative(
[out] PISECURITY_DESCRIPTOR_RELATIVE SecurityDescriptor,
[in] ULONG Revision
);
Parameter
[out] SecurityDescriptor
Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der mindestens sizeof(SECURITY_DESCRIPTOR_RELATIVE) sein muss, um den initialisierten Sicherheitsdeskriptor zu empfangen.
[in] Revision
Revisionsebene, die dem Sicherheitsdeskriptor zugewiesen werden soll. Dieser Parameter muss SECURITY_DESCRIPTOR_REVISION werden.
Rückgabewert
RtlCreateSecurityDescriptorRelative kann eine der folgenden Rückgaben zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Aufruf wurde erfolgreich abgeschlossen. |
|
Die angegebene Revision ist nicht bekannt oder wird nicht unterstützt. |
Hinweise
Tatsächlich initialisiert ein erfolgreicher Aufruf dieser Routine einen Sicherheitsdeskriptor ohne Sicherheitseinschränkungen.
Weitere Informationen zur Sicherheit und Zugriffssteuerung finden Sie unter Windows-Sicherheitsmodell für Treiberentwickler und in der Dokumentation zu diesen Themen im Windows SDK.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 |
| Zielplattform | Desktop |
| Kopfzeile | ntifs.h (include Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |