NCRYPT_UI_POLICY-Struktur (ncrypt.h)

Die NCRYPT_UI_POLICY-Struktur wird zusammen mit der eigenschaft NCRYPT_UI_POLICY_PROPERTY verwendet, um informationen zur Benutzeroberfläche für einen Schlüssel zu enthalten. Diese Struktur wird mit den Funktionen NCryptSetProperty und NCryptGetProperty mit der eigenschaft NCRYPT_UI_POLICY_PROPERTY verwendet.

Syntax

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

Member

dwVersion

Die Versionsnummer der -Struktur. Dieser Member muss 1 enthalten.

dwFlags

Eine Reihe von Flags, die zusätzliche Benutzeroberflächeninformationen oder -anforderungen bereitstellen.

Wert	Bedeutung
NCRYPT_UI_PROTECT_KEY_FLAG 0x00000001	Zeigen Sie die Benutzeroberfläche mit starkem Schlüssel nach Bedarf an.
NCRYPT_UI_FORCE_HIGH_PROTECTION_FLAG 0x00000002	Erzwingen sie einen hohen Schutz.
NCRYPT_UI_APPCONTAINER_ACCESS_MEDIUM_FLAG 0x00000008	Ein App-Container hat auf einen mittleren Schlüssel zugegriffen, der nicht stark geschützt ist. Beispielsweise ein Schlüssel, der nur für die Benutzereinwilligung vorgesehen ist oder kennwort- oder fingerabdruckgeschützter Ist.

pszCreationTitle

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Text enthält, der im Titel des Dialogfelds mit starkem Schlüssel verwendet wird, wenn der Schlüssel abgeschlossen ist. Wenn dieser Member NULL ist, wird im Dialogfeld mit starkem Schlüssel ein Standarderstellungstitel verwendet. Dieser Member wird nur bei der Schlüsselabschlusserstellung verwendet.

pszFriendlyName

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Text enthält, der im Dialogfeld mit starkem Schlüssel als Name des Schlüssels angezeigt wird. Wenn dieser Member NULL ist, wird im Dialogfeld mit starkem Schlüssel ein Standardname verwendet. Dieser Member wird sowohl beim Abschließen des Schlüssels als auch bei Verwendung des Schlüssels verwendet.

pszDescription

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Termin, die den Text enthält, der im Dialogfeld mit starkem Schlüssel als Beschreibung des Schlüssels angezeigt wird. Wenn dieser Member NULL ist, wird im Dialogfeld mit starkem Schlüssel eine Standardbeschreibung verwendet. Dieser Member wird sowohl beim Abschließen des Schlüssels als auch bei Verwendung des Schlüssels verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	ncrypt.h