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 |
|---|---|
|
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 |