Fonction de rappel SpExportSecurityContextFn (ntsecpkg.h)

Article
03/04/2024

Exporte un contexte de sécurité vers un autre processus.

La fonction SpExportSecurityContext est la fonction dispatch de la fonction ExportSecurityContext de l’interface du fournisseur de support de sécurité.

Syntaxe

SpExportSecurityContextFn Spexportsecuritycontextfn;

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

Paramètres

[in] phContext

Handle vers le contexte de sécurité à exporter.

[in] fFlags

facultatif. Spécifie les options de duplication de contexte. Le tableau suivant répertorie les valeurs valides définies dans Sspi.h.

Valeur	Signification
SECPKG_CONTEXT_EXPORT_RESET_NEW	Le nouveau contexte est réinitialisé à l’état initial.
SECPKG_CONTEXT_EXPORT_DELETE_OLD	L’ancien contexte est supprimé lors de l’exportation.

[out] pPackedContext

Pointeur vers une structure SecBuffer contenant le contexte sérialisé . Les ressources doivent être allouées à l’aide de la fonction AllocateClientBuffer et libérées par l’appelant à l’aide de la fonction FreeContextBuffer .

[out] pToken

facultatif. Pointeur vers un handle qui reçoit le jeton du contexte.

Valeur retournée

Si la fonction réussit, retournez STATUS_SUCCESS.

Si la fonction échoue, retournez un code NTSTATUS qui indique la raison de son échec.

Remarques

Pour importer un contexte de sécurité précédemment exporté, utilisez la fonction SpImportSecurityContext .

SSP/APs doivent implémenter la fonction SpExportSecurityContext ; toutefois, le nom réel donné à l’implémentation appartient au développeur.

Un pointeur vers la fonction SpExportSecurityContext est disponible dans la structure SECPKG_USER_FUNCTION_TABLE reçue de la fonction SpUserModeInitialize .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ntsecpkg.h

Voir aussi

SECPKG_USER_FUNCTION_TABLE

SpImportSecurityContext

SpUserModeInitialize

Partager via