NCRYPT_UI_POLICY structure

The NCRYPT_UI_POLICY structure is used with the NCRYPT_UI_POLICY_PROPERTY property to contain strong key user interface information for a key. This structure is used with the NCryptSetProperty and NCryptGetProperty functions with the NCRYPT_UI_POLICY_PROPERTY property.

Syntax

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

Members

dwVersion

The version number of the structure. This member must contain 1.

dwFlags

A set of flags that provide additional user interface information or requirements.

Value	Meaning
NCRYPT_UI_PROTECT_KEY_FLAG 0x00000001	Display the strong key user interface as needed.
NCRYPT_UI_FORCE_HIGH_PROTECTION_FLAG 0x00000002	Force high protection.

 

pszCreationTitle

A pointer to a null-terminated Unicode string that contains the text that will be used in the title of the strong key dialog box when the key is completed. If this member is NULL, a default creation title will be used in the strong key dialog box. This member is only used on key finalization.

pszFriendlyName

A pointer to a null-terminated Unicode string that contains the text that will be displayed in the strong key dialog box as the name of the key. If this member is NULL, a default name will be used in the strong key dialog box. This member is used both when the key is completed and when the key is used.

pszDescription

A pointer to a null-terminated Unicode string that contains the text that will be displayed in the strong key dialog box as the description of the key. If this member is NULL, a default description will be used in the strong key dialog box. This member is used both when the key is completed and when the key is used.

Requirements

Send comments about this topic to Microsoft

Build date: 11/14/2012