SpExportSecurityContextFn-Rückruffunktion (ntsecpkg.h)

Artikel
03/06/2024

Exportiert einen Sicherheitskontext in einen anderen Prozess.

Die SpExportSecurityContext-Funktion ist die Dispatchfunktion für die ExportSecurityContext-Funktion der Security Support Provider Interface.

Syntax

SpExportSecurityContextFn Spexportsecuritycontextfn;

NTSTATUS Spexportsecuritycontextfn(
  [in]  LSA_SEC_HANDLE phContext,
  [in]  ULONG fFlags,
  [out] PSecBuffer pPackedContext,
  [out] PHANDLE pToken
)
{...}

Parameter

[in] phContext

Ein Handle für den zu exportierenden Sicherheitskontext.

[in] fFlags

Optional. Gibt Optionen für die Kontextduplizierung an. In der folgenden Tabelle sind die gültigen Werte aufgeführt, die in Sspi.h definiert sind.

Wert	Bedeutung
SECPKG_CONTEXT_EXPORT_RESET_NEW	Neuer Kontext wird auf den Anfangszustand zurückgesetzt.
SECPKG_CONTEXT_EXPORT_DELETE_OLD	Der alte Kontext wird während des Exports gelöscht.

[out] pPackedContext

Zeiger auf eine SecBuffer-Struktur , die den serialisierten Kontext enthält. Ressourcen sollten mithilfe der AllocateClientBuffer-Funktion zugeordnet und vom Aufrufer mithilfe der FreeContextBuffer-Funktion freigegeben werden.

[out] pToken

Optional. Zeiger auf ein Handle, das das Token des Kontexts empfängt.

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.

Hinweise

Verwenden Sie zum Importieren eines zuvor exportierten Sicherheitskontexts die Funktion SpImportSecurityContext .

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

Ein Zeiger auf die SpExportSecurityContext-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

SpImportSecurityContext

SpUserModeInitialize

Freigeben über