Funzione di callback spExportSecurityContextFn (ntsecpkg.h)

Articolo
02/29/2024

Esporta un contesto di sicurezza in un altro processo.

La funzione SpExportSecurityContext è la funzione di invio per la funzione ExportSecurityContext dell'interfaccia del provider di supporto della sicurezza.

Sintassi

SpExportSecurityContextFn Spexportsecuritycontextfn;

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

Parametri

[in] phContext

Handle al contesto di sicurezza da esportare.

[in] fFlags

facoltativo. Specifica le opzioni di duplicazione del contesto. Nella tabella seguente sono elencati i valori validi definiti in Sspi.h.

Valore	Significato
SECPKG_CONTEXT_EXPORT_RESET_NEW	Il nuovo contesto viene reimpostato sullo stato iniziale.
SECPKG_CONTEXT_EXPORT_DELETE_OLD	Il contesto precedente viene eliminato durante l'esportazione.

[out] pPackedContext

Puntatore a una struttura SecBuffer contenente il contesto serializzato . Le risorse devono essere allocate usando la funzione AllocateClientBuffer e liberate dal chiamante usando la funzione FreeContextBuffer .

[out] pToken

facoltativo. Puntatore a un handle che riceve il token del contesto.

Valore restituito

Se la funzione ha esito positivo, restituire STATUS_SUCCESS.

Se la funzione ha esito negativo, restituisce un codice NTSTATUS che indica il motivo per cui non è riuscito.

Commenti

Per importare un contesto di sicurezza esportato in precedenza, usare la funzione SpImportSecurityContext .

SSP/APs deve implementare la funzione SpExportSecurityContext ; tuttavia, il nome effettivo assegnato all'implementazione è fino allo sviluppatore.

Un puntatore alla funzione SpExportSecurityContext è disponibile nella struttura SECPKG_USER_FUNCTION_TABLE ricevuta dalla funzione SpUserModeInitialize .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntsecpkg.h

Vedi anche

SECPKG_USER_FUNCTION_TABLE

SpImportSecurityContext

SpUserModeInitialize

Condividi tramite