Funzione ImportSecurityContextW (sspi.h)

Articolo
11/20/2024

La funzione ImportSecurityContext importa un contesto di sicurezza . Il contesto di sicurezza deve essere stato esportato nel processo che chiama ImportSecurityContext da una chiamata precedente a ExportSecurityContext.

Sintassi

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ImportSecurityContextW(
  [in]           PSECURITY_STRING pszPackage,
  [in]           PSecBuffer       pPackedContext,
  [in, optional] void             *Token,
  [out]          PCtxtHandle      phContext
);

Parametri

[in] pszPackage

Stringa contenente il nome del pacchetto di sicurezza in cui è stato esportato il contesto di sicurezza .

[in] pPackedContext

Puntatore a un buffer contenente il serializzato contesto di sicurezza creato da ExportSecurityContext.

[in, optional] Token

Handle per il token del contesto.

[out] phContext

Handle del nuovo contesto di sicurezza creato da pPackedContext. Al termine dell'uso del contesto, eliminarlo chiamando la funzione deleteSecurityContext .

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_UNKNOWN_CREDENTIALS	Le credenziali fornite al pacchetto non sono state riconosciute.
SEC_E_NO_CREDENTIALS	Nessuna credenziale è disponibile nel pacchetto di sicurezza .
SEC_E_NOT_OWNER	Il chiamante della funzione non dispone delle credenziali necessarie.
SEC_E_INSUFFICIENT_MEMORY	Memoria insufficiente per completare l'azione richiesta.
SEC_E_INTERNAL_ERROR	Si è verificato un errore che non è stato mappato a un codice di errore SSPI.

Osservazioni

Nota

L'intestazione sspi.h definisce ImportSecurityContext come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	sspi.h (include Security.h)
libreria	Secur32.lib
dll	Secur32.dll

Vedere anche

ExportSecurityContext

FreeContextBuffer

funzioni SSPI

Condividi tramite