structure NCRYPT_UI_POLICY (ncrypt.h)

  • Article

La structure NCRYPT_UI_POLICY est utilisée avec la propriété NCRYPT_UI_POLICY_PROPERTY pour contenir des informations d’interface utilisateur de clé forte pour une clé. Cette structure est utilisée avec les fonctions NCryptSetProperty et NCryptGetProperty avec la propriété NCRYPT_UI_POLICY_PROPERTY .

Syntaxe

typedef struct __NCRYPT_UI_POLICY {
  DWORD   dwVersion;
  DWORD   dwFlags;
  LPCWSTR pszCreationTitle;
  LPCWSTR pszFriendlyName;
  LPCWSTR pszDescription;
} NCRYPT_UI_POLICY;

Membres

dwVersion

Numéro de version de la structure. Ce membre doit contenir 1.

dwFlags

Ensemble d’indicateurs qui fournissent des informations ou des exigences supplémentaires sur l’interface utilisateur.

Valeur Signification
NCRYPT_UI_PROTECT_KEY_FLAG
0x00000001
 Affichez l’interface utilisateur à clé forte si nécessaire.
NCRYPT_UI_FORCE_HIGH_PROTECTION_FLAG
0x00000002
 Forcer une protection élevée.
NCRYPT_UI_APPCONTAINER_ACCESS_MEDIUM_FLAG
0x00000008
 Un conteneur d’application a accédé à une clé moyenne qui n’est pas fortement protégée. Par exemple, une clé pour le consentement de l’utilisateur uniquement, ou qui est protégée par mot de passe ou empreinte digitale.

pszCreationTitle

Pointeur vers une chaîne Unicode terminée par null qui contient le texte qui sera utilisé dans le titre de la boîte de dialogue de clé forte une fois la clé terminée. Si ce membre a la valeur NULL, un titre de création par défaut est utilisé dans la boîte de dialogue à clé forte. Ce membre est utilisé uniquement lors de la finalisation de la clé.

pszFriendlyName

Pointeur vers une chaîne Unicode terminée par null qui contient le texte qui sera affiché dans la boîte de dialogue à clé forte comme nom de la clé. Si ce membre a la valeur NULL, un nom par défaut est utilisé dans la boîte de dialogue clé forte. Ce membre est utilisé à la fois lorsque la clé est terminée et lorsque la clé est utilisée.

pszDescription

Pointeur vers une chaîne Unicode terminée par null qui contient le texte qui sera affiché dans la boîte de dialogue à clé forte comme description de la clé. Si ce membre a la valeur NULL, une description par défaut est utilisée dans la boîte de dialogue à clé forte. Ce membre est utilisé à la fois lorsque la clé est terminée et lorsque la clé est utilisée.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête ncrypt.h