SpExportSecurityContextFn-Rückruffunktion (ntsecpkg.h)

  • Artikel

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