SpInitUserModeContextFn-Rückruffunktion (ntsecpkg.h)

Die SpInitUserModeContext-Funktion erstellt einen Sicherheitskontext im Benutzermodus aus einem gepackten LSA-Modus ( Local Security Authority ).

Syntax

SpInitUserModeContextFn Spinitusermodecontextfn;

NTSTATUS Spinitusermodecontextfn(
  [in] LSA_SEC_HANDLE ContextHandle,
  [in] PSecBuffer PackedContext
)
{...}

Parameter

[in] ContextHandle

Ein Handle für den LSA-Moduskontext, der von der SpInitLsaModeContext- oder SpAcceptLsaModeContext-Funktion zurückgegeben wird.

[in] PackedContext

Zeiger auf eine SecBuffer-Struktur , die die serialisierten Kontextdaten enthält. Verwenden Sie die FreeContextBuffer-Funktion , um den für diese Struktur zugewiesenen Arbeitsspeicher freizugeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, geben Sie STATUS_SUCCESS zurück.

Wenn die Funktion fehlschlägt, geben Sie einen NTSTATUS-Code zurück, der den Grund für den Fehler angibt. Im Folgenden werden ein häufiger Fehlergrund und der Fehlercode aufgeführt, den die Funktion zurückgeben soll.

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Unzureichender Arbeitsspeicher zum Erstellen des Kontexts.

Hinweise

Die SpInitUserModeContext-Funktion wird aufgerufen, nachdem ein Sicherheitskontext vom Sicherheitspaket erstellt wurde, wenn der MappedContext-Parameter von SpInitLsaModeContext oder SpAcceptLsaModeContext auf TRUE festgelegt ist. Die paketspezifischen Kontextdaten sollten die Informationen enthalten, die erforderlich sind, um zu bestimmen, welche Funktion zum Aufruf von SpInitUserModeContext geführt hat.

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

Ein Zeiger auf die SpInitUserModeContext-Funktion ist in der SECPKG_USER_FUNCTION_TABLE-Struktur verfügbar, die von der SpUserModeInitialize-Funktion empfangen 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_USER_FUNCTION_TABLE

SpAcceptLsaModeContext

SpInitLsaModeContext

SpUserModeInitialize