Funzione ExportSecurityContext (sspi.h)

Articolo
03/05/2024

La funzione ExportSecurityContext crea una rappresentazione serializzata di un contesto di sicurezza che può essere importato in un processo diverso chiamando
ImportSecurityContext. Il processo che importa il contesto di sicurezza deve essere in esecuzione nello stesso computer del processo denominato ExportSecurityContext.

Sintassi

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ExportSecurityContext(
  [in]            PCtxtHandle phContext,
  [in]            ULONG       fFlags,
  [out]           PSecBuffer  pPackedContext,
  [out, optional] void        **pToken
);

Parametri

[in] phContext

Handle del contesto di sicurezza da esportare.

[in] fFlags

Questo parametro può essere una combinazione bit per bit-OR dei valori seguenti.

Valore	Significato
SECPKG_CONTEXT_EXPORT_RESET_NEW 1 (0x1)	Il nuovo contesto di sicurezza viene reimpostato sullo stato iniziale.
SECPKG_CONTEXT_EXPORT_DELETE_OLD 2 (0x2)	Il contesto di sicurezza precedente viene eliminato.
SECPKG_CONTEXT_EXPORT_TO_KERNEL 4 (0x4)	Questo valore non è supportato. Windows Server 2003 e Windows XP/2000: Il contesto di sicurezza deve essere esportato nel kernel. Questo valore è supportato solo in modalità kernel Schannel.

[out] pPackedContext

Puntatore a un buffer di tipo SECBUFFER_EMPTY che riceve il contesto di sicurezza serializzato . Al termine dell'uso di questo contesto, liberarlo chiamando la funzione FreeContextBuffer .

[out, optional] pToken

Puntatore per ricevere l'handle del token del contesto.

Al termine dell'uso del token utente, rilasciare l'handle chiamando la funzione CloseHandle .

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce SEC_E_OK.

Se la funzione ha esito negativo, restituisce uno dei codici di errore seguenti.

Codice restituito	Descrizione
SEC_E_INSUFFICIENT_MEMORY	Non è disponibile memoria sufficiente per completare l'azione richiesta.
SEC_E_INVALID_HANDLE	Il parametro phContext non punta a un handle valido.
SEC_E_NOT_SUPPORTED	La modalità kernel Schannel non supporta questa funzione.

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	sspi.h (includere Security.h)
Libreria	Secur32.lib
DLL	Secur32.dll

Vedi anche

FreeContextBuffer

ImportSecurityContext

Funzioni SSPI

Condividi tramite