NCRYPT_UI_POLICY_BLOB Struktur

Die NCRYPT_UI_POLICY_BLOB-Struktur wird mit der NCRYPT_UI_POLICY_PROPERTY-Eigenschaft verwendet, um Benutzeroberflächeninformationen für einen Schlüssel zu enthalten.

Syntax

typedef struct __NCRYPT_UI_POLICY_BLOB {
  DWORD dwVersion;
  DWORD dwFlags;
  DWORD cbCreationTitle;
  DWORD cbFriendlyName;
  DWORD cbDescription;
} NCRYPT_UI_POLICY_BLOB;

Member

dwVersion

Die Versionsnummer der Struktur. Dieses Element 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 für starke Schlüssel nach Bedarf an.
NCRYPT_UI_FORCE_HIGH_PROTECTION_FLAG 0x00000002	Erzwingen Sie einen hohen Schutz.

cbCreationTitle

Die Länge des Erstellungstitels in Bytes. Der Erstellungstitel ist eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Text angibt, der als Titel des Dialogfelds mit starkem Schlüssel verwendet wird, wenn der Schlüssel abgeschlossen ist. Der Erstellungstitel muss unmittelbar nach der NCRYPT_UI_POLICY_BLOB-Struktur platziert werden. Wenn der Wert des cbCreationTitle-Elements auf 0 festgelegt ist, wird ein Standarderstellungstitel für den Titel des Dialogfelds mit starkem Schlüssel verwendet. Dieses Element wird nur für die Schlüsselabschlusserstellung verwendet.

cbFriendlyName

Die Länge des Anzeigenamens des Schlüssels in Bytes. Der Anzeigename ist eine mit NULL beendete Unicode-Zeichenfolge, die den Text enthält, der im Dialogfeld starke Taste als Name des Schlüssels angezeigt wird. Der Anzeigename muss unmittelbar nach dem Erstellungstitel in diesem BLOB platziert werden. Wenn der Wert des cbFriendlyName-Members auf 0 festgelegt ist, wird im Dialogfeld mit starkem Schlüssel ein Standardname verwendet. Dieses Element wird sowohl beim Abschließen des Schlüssels als auch bei Verwendung des Schlüssels verwendet.

cbDescription

Die Länge der Schlüsselbeschreibung in Bytes. Die Schlüsselbeschreibung ist eine UNICODE-Zeichenfolge mit NULL-Beendigung, die den Text enthält, der im Dialogfeld mit starkem Schlüssel als Beschreibung des Schlüssels angezeigt wird. Der Beschreibungswert muss unmittelbar nach dem Anzeigenamen in diesem BLOB platziert werden. Wenn der Wert des cbDescription-Members auf 0 festgelegt ist, wird eine Standardbeschreibung im Dialogfeld starke Taste verwendet. Dieses Element wird sowohl beim Abschließen des Schlüssels als auch bei Verwendung des Schlüssels verwendet.

Bemerkungen

Diese Struktur ist im Ncrypt_provider.h-Header enthalten. Um die Struktur verwenden zu können, müssen Sie das Cryptographic Provider Development Kit von Microsoft Connect herunterladen.

Anforderungen

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