SpInitializeFn-Rückruffunktion (ntsecpkg.h)

  • Artikel

Die SpInitialize-Funktion wird einmal von der lokalen Sicherheitsbehörde (Local Security Authority , LSA) aufgerufen, um ein Sicherheitspaket mit allgemeinen Sicherheitsinformationen und eine Bereitstellungstabelle mit Unterstützungsfunktionen bereitzustellen. Das Sicherheitspaket sollte die Informationen speichern und ggf. interne Initialisierungsverarbeitung durchführen.

Syntax

SpInitializeFn Spinitializefn;

NTSTATUS Spinitializefn(
  [in] ULONG_PTR PackageId,
  [in] PSECPKG_PARAMETERS Parameters,
  [in] PLSA_SECPKG_FUNCTION_TABLE FunctionTable
)
{...}

Parameter

[in] PackageId

Ein eindeutiger Bezeichner, den der LSA jedem Sicherheitspaket zuweist. Der Wert ist gültig, bis das System neu gestartet wird.

[in] Parameters

Ein Zeiger auf eine SECPKG_PARAMETERS Struktur, die Informationen zum primären Domänen- und Computerstatus enthält.

[in] FunctionTable

Zeiger auf eine Tabelle mit LSA-Unterstützungsfunktionen, die von einem Sicherheitspaket aufgerufen werden können.

Rückgabewert

Wenn die Funktion erfolgreich ist, geben Sie STATUS_SUCCESS oder einen informationellen status Code zurück.

Wenn die Funktion fehlschlägt, geben Sie einen NTSTATUS-Fehlercode zurück, der den Grund für einen Fehler angibt. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

Wenn SpInitialize einen NTSTATUS-Fehlercode an den LSA zurückgibt, wird das Paket entladen, und die lokale Sicherheitsbehörde (Local Security Authority , LSA) enthält es nicht in der Liste der verfügbaren Sicherheitspakete.

SSP/APs müssen die SpInitialize-Funktion implementieren. Der tatsächliche Name, der der Implementierung zugewiesen wird, liegt jedoch beim Entwickler.

Ein Zeiger auf die Implementierung der SpInitialize-Funktion durch SSP/AP muss sich in der SECPKG_FUNCTION_TABLE Struktur befinden, die von der SpLsaModeInitialize-Funktion an den LSA übergeben wird.

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 ntsecpkg.h

Weitere Informationen

SECPKG_FUNCTION_TABLE

SECPKG_PARAMETERS

SpLsaModeInitialize