Rückgabewerte der Sicherheitsverwaltung

Die Rückgabewerte für die Sicherheitsverwaltung umfassen Folgendes:

• Anlagenrückgabewerte
• Rückgabewerte der LSA-Richtlinienfunktion

Anlagenrückgabewerte

Der Sicherheitskonfigurationstoolsatz unterstützt die folgenden SCESTATUS-Rückgabecodes . Diese Werte werden von den Anlagenunterstützungsfunktionen und den Funktionen zurückgegeben, die beim Schreiben einer Anlage-Engine oder eines Snap-Ins implementiert werden.

Wert	BESCHREIBUNG
SCESTATUS_SUCCESS	Die Funktion wurde erfolgreich ausgeführt.
SCESTATUS_INVALID_PARAMETER	Einer der an die Funktion übergebenen Parameter war ungültig.
SCESTATUS_RECORD_NOT_FOUND	Der angegebene Datensatz wurde in der Sicherheitsdatenbank nicht gefunden.
SCESTATUS_INVALID_DATA	Die Funktion ist fehlgeschlagen, weil einige Daten ungültig waren.
SCESTATUS_OBJECT_EXISTS	Das Objekt ist bereits vorhanden.
SCESTATUS_BUFFER_TOO_SMALL	Der an die Funktion übergebene Puffer zum Empfangen von Daten ist nicht groß genug, um alle Daten zu empfangen.
SCESTATUS_PROFILE_NOT_FOUND	Das angegebene Profil wurde nicht gefunden.
SCESTATUS_BAD_FORMAT	Das Format ist ungültig.
SCESTATUS_NOT_ENOUGH_RESOURCE	Es ist nicht genügend Arbeitsspeicher vorhanden.
SCESTATUS_ACCESS_DENIED	Der Aufrufer verfügt nicht über ausreichende Berechtigungen, um diese Aktion abzuschließen.
SCESTATUS_CANT_DELETE	Die Funktion kann das angegebene Element nicht löschen.
SCESTATUS_PREFIX_OVERFLOW	Ein Präfixüberlauf ist aufgetreten.
SCESTATUS_OTHER_ERROR	Ein unbekannter Fehler ist aufgetreten.
SCESTATUS_ALREADY_RUNNING	Der Dienst wird schon ausgeführt.
SCESTATUS_SERVICE_NOT_SUPPORT	Der angegebene Dienst wird nicht unterstützt.
SCESTATUS_MOD_NOT_FOUND	Eine in der Registrierung aufgeführte DLL der Anlagen-Engine wurde entweder nicht gefunden oder nicht geladen.
SCESTATUS_EXCEPTION_IN_SERVER	Auf dem Server ist eine Ausnahme aufgetreten.

Rückgabewerte der LSA-Richtlinienfunktion

Die meisten LSA-Richtlinienfunktionen ( Local Security Authority ) geben einen NTSTATUS-Wert zurück, um Erfolg oder Fehler anzugeben. Die verschiedenen NTSTATUS-Werte werden in Ntstatus.h definiert, das mit dem Microsoft Windows Driver Development Kit (DDK) verteilt wird.

Verwenden Sie die Funktion LsaNtStatusToWinError , um einen NTSTATUS-Rückgabewert in einen Windows-Fehlercode zu konvertieren.

In der folgenden Tabelle sind die NTSTATUS-Werte aufgeführt, die von jeder LSA-Funktion zurückgegeben werden können. (Die Rückgabewertabschnitte für einige der LSA-Funktionen enthalten zusätzliche Fehlercodes, die die Funktion möglicherweise zurückgibt.) In dieser Tabelle ist auch der Windows-Fehlercode aufgeführt, der den einzelnen NTSTATUS-Werten entspricht.

NTSTATUS-Code (Windows-Fehlercode)	Bedeutung
STATUS_SUCCESS (ERROR_SUCCESS)	Die Funktion war erfolgreich.
STATUS_ACCESS_DENIED (ERROR_ACCESS_DENIED)	Der Aufrufer verfügt nicht über den entsprechenden Zugriff, um den Vorgang abzuschließen.
STATUS_INSUFFICIENT_RESOURCES (ERROR_NO_SYSTEM_RESOURCES)	Es gibt nicht genügend Systemressourcen (z. B. Arbeitsspeicher zum Zuweisen von Puffern), um den Aufruf abzuschließen.
STATUS_INTERNAL_DB_ERROR (ERROR_INTERNAL_DB_ERROR)	Die LSA-Datenbank enthält eine interne Inkonsistenz.
STATUS_INVALID_HANDLE (ERROR_INVALID_HANDLE)	Gibt an, dass ein Objekt oder RPC-Handle im verwendeten Kontext ungültig ist.
STATUS_INVALID_SERVER_STATE (ERROR_INVALID_SERVER_STATE)	Gibt an, dass der LSA-Server derzeit deaktiviert ist.
STATUS_INVALID_PARAMETER (ERROR_INVALID_PARAMETER)	Einer der Parameter ist ungültig.
STATUS_NO_SUCH_PRIVILEGE (ERROR_NO_SUCH_PRIVILEGE)	Gibt an, dass eine angegebene Berechtigung nicht vorhanden ist.
STATUS_OBJECT_NAME_NOT_FOUND (ERROR_FILE_NOT_FOUND)	Ein Objekt in der LSA-Richtliniendatenbank wurde nicht gefunden. Das Objekt wurde je nach Typ möglicherweise entweder durch SID oder anhand des Namens angegeben.
STATUS_UNSUCCESSFUL (ERROR_GEN_FAILURE)	Allgemeiner Fehler, z. B. RPC-Verbindungsfehler.