Funzione ImportSecurityContextA (sspi.h)

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

SECURITY_STATUS SEC_ENTRY ImportSecurityContextA(
  [in]           LPSTR       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 contesto di sicurezza serializzato 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
Non è disponibile memoria sufficiente per completare l'azione richiesta.
SEC_E_INTERNAL_ERROR
Si è verificato un errore che non è stato eseguito il mapping a un codice di errore SSPI.

Commenti

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 di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di 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

ExportSecurityContext

FreeContextBuffer

Funzioni SSPI