SpInitializeFn-Rückruffunktion (ntsecpkg.h)
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 |