Kryptografiegrundtyp-Eigenschaftsbezeichner

In diesem Artikel werden die kryptografischen primitiven Eigenschaftsbezeichner erläutert, die mit den Funktionen BCryptGetProperty und BCryptSetProperty verwendet werden. Erfahren Sie, wie diese Werte zur Identifizierung von Eigenschaften in kryptografischen Algorithmen beitragen.

BCRYPT_ALGORITHM_NAME

L"AlgorithmName"

Eine mit Null beendete Unicode-Zeichenfolge, die den Namen des Algorithmus enthält.

BCRYPT_AUTH_TAG_LENGTH

L"AuthTagLength"

Die Längen der Authentifizierungstags, die vom Algorithmus unterstützt werden. Diese Eigenschaft ist eine BCRYPT_AUTH_TAG_LENGTHS_STRUCT Struktur. Diese Eigenschaft gilt nur für Algorithmen.

BCRYPT_BLOCK_LENGTH

L"BlockLength"

Die Größe eines Chiffreblocks in Bytes für den Algorithmus. Diese Eigenschaft gilt nur für Blockchiffrealgorithmen. Dieser Datentyp ist ein DWORD.

BCRYPT_BLOCK_SIZE_LIST

L"BlockSizeList"

Eine Liste der blocklängen, die von einem Verschlüsselungsalgorithmus unterstützt werden. Dieser Datentyp ist ein Array von DWORDs. Die Anzahl der Elemente im Array kann bestimmt werden, indem die Anzahl der Bytes dividiert wird, die durch die Größe eines einzelnen DWORD abgerufen werden.

BCRYPT_CHAINING_MODE

L"ChainingMode"

Ein Zeiger auf eine mit Null beendete Unicode-Zeichenfolge, die den Verkettungsmodus des Verschlüsselungsalgorithmus darstellt. Diese Eigenschaft kann für ein Algorithmushandle oder ein Schlüsselhandle auf einen der folgenden Werte festgelegt werden.

Kennung	Wert	BESCHREIBUNG
BCRYPT_CHAIN_MODE_CBC	L"ChainingModeCBC"	Legt den Verkettungsmodus des Algorithmus auf Chiffreblockkette fest.
BCRYPT_CHAIN_MODE_CCM	L"ChainingModeCCM"	Legt den Verkettungsmodus des Algorithmus so fest, dass er mit CBC-MAC Modus (CCM) zählert. Unterstützt Schlüssellängen von 128, 192 und 256 Bit. Anmerkung: Dieser Wert wird ab Windows Vista mit SP1 unterstützt.
BCRYPT_CHAIN_MODE_CFB	L"ChainingModeCFB"	Legt den Verkettungsmodus des Algorithmus auf Chiffrefeedback fest.
BCRYPT_CHAIN_MODE_ECB	L"ChainingModeECB"	Legt den Verkettungsmodus des Algorithmus auf ein elektronisches Codebook fest.
BCRYPT_CHAIN_MODE_GCM	L"ChainingModeGCM"	Legt den Verkettungsmodus des Algorithmus auf galois/counter mode (GCM) fest. Unterstützt Schlüssellängen von 128, 192 und 256 Bit. Anmerkung: Dieser Wert wird ab Windows Vista mit SP1 unterstützt.
BCRYPT_CHAIN_MODE_NA	L"ChainingModeN/A"	Der Algorithmus unterstützt keine Verkettung.

BCRYPT_DH_PARAMETERS

L"DHParameters"

Gibt Parameter an, die mit einem Diffie-Hellman-Schlüssel verwendet werden sollen. Dieser Datentyp ist ein Zeiger auf eine BCRYPT_DH_PARAMETER_HEADER Struktur. Diese Eigenschaft kann nur festgelegt werden und muss für den Schlüssel festgelegt werden, bevor der Schlüssel abgeschlossen ist.

BCRYPT_DSA_PARAMETERS

L"DSAParameters"

Gibt Parameter an, die mit einem DSA-Schlüssel verwendet werden sollen. Diese Eigenschaft ist eine BCRYPT_DSA_PARAMETER_HEADER oder eine BCRYPT_DSA_PARAMETER_HEADER_V2 Struktur. Diese Eigenschaft kann nur festgelegt werden und muss für den Schlüssel festgelegt werden, bevor der Schlüssel abgeschlossen ist.

Windows 8: Ab Windows 8 kann diese Eigenschaft eine BCRYPT_DSA_PARAMETER_HEADER_V2 Struktur sein. Verwenden Sie diese Struktur, wenn die Schlüsselgröße 1024 Bit überschreitet und kleiner als oder gleich 3072 Bit ist. Wenn die Schlüsselgröße größer oder gleich 512, aber kleiner oder gleich 1024 Bit ist, verwenden Sie die BCRYPT_DSA_PARAMETER_HEADER Struktur.

BCRYPT_EFFECTIVE_KEY_LENGTH

L"EffectiveKeyLength"

Die Größe in Bits der effektiven Länge eines RC2-Schlüssels. Dieser Datentyp ist ein DWORD.

BCRYPT_HASH_BLOCK_LENGTH

L"HashBlockLength"

Die Größe des Blocks für einen Hash in Byte. Diese Eigenschaft gilt nur für Hashalgorithmen. Dieser Datentyp ist ein DWORD.

BCRYPT_HASH_LENGTH

L"HashDigestLength"

Die Größe des Hashwerts eines Hashanbieters in Bytes. Dieser Datentyp ist ein DWORD.

BCRYPT_HASH_OID_LIST

L"HashOIDList"

Die Liste der DER-codierten Hashing-Objektbezeichner (OIDs). Diese Eigenschaft ist eine BCRYPT_OID_LIST Struktur. Diese Eigenschaft kann nur gelesen werden.

BCRYPT_INITIALIZATION_VECTOR

L"IV"

Enthält den Initialisierungsvektor (IV) für einen Schlüssel. Diese Eigenschaft gilt nur für Schlüssel.

BCRYPT_KEM_SHARED_SECRET_LENGTH

L"BCRYPT_KEM_SHARED_SECRET_LENGTH"

Die Größe des freigegebenen geheimen Schlüssels in Bytes für einen KEM-Schlüssel (Key Kapselungsmechanismus). Dieser Datentyp ist ein DWORD.

BCRYPT_KEM_CIPHERTEXT_LENGTH

L"BCRYPT_KEM_CIPHERTEXT_LENGTH"

Die Größe des Chiffretexts für einen KEM-Schlüssel (Key Kapselungsmechanismus) in Bytes. Dieser Datentyp ist ein DWORD.

BCRYPT_KEY_LENGTH

L"KeyLength"

Die Größe des Schlüsselwerts eines symmetrischen Schlüsselanbieters in Bits. Dieser Datentyp ist ein DWORD.

BCRYPT_KEY_LENGTHS

L"KeyLengths"

Die Schlüssellängen, die vom Algorithmus unterstützt werden. Diese Eigenschaft ist eine BCRYPT_KEY_LENGTHS_STRUCT Struktur. Diese Eigenschaft gilt nur für Algorithmen.

BCRYPT_KEY_OBJECT_LENGTH

L"KeyObjectLength"

Diese Eigenschaft wird nicht verwendet. Die BCRYPT_OBJECT_LENGTH-Eigenschaft wird verwendet, um diese Informationen abzurufen.

BCRYPT_KEY_STRENGTH

L"KeyStrength"

Die Anzahl der Bits im Schlüssel. Dieser Datentyp ist ein DWORD. Diese Eigenschaft gilt nur für Schlüssel.

BCRYPT_MESSAGE_BLOCK_LENGTH

L"MessageBlockLength"

Dies kann für jeden Tastenziehpunkt festgelegt werden, der den CFB-Verkettungsmodus festgelegt hat. Standardmäßig ist diese Eigenschaft für 8-Bit-CFB auf 1 festgelegt. Wenn sie auf die Blockgröße in Bytes festgelegt wird, wird CFB mit Vollblock verwendet. Bei XTS-Schlüsseln wird die Größe der XTS-Dateneinheit (häufig 512 oder 4096) in Byte festgelegt.

BCRYPT_MULTI_OBJECT_LENGTH

L"MultiObjectLength"

Diese Eigenschaft gibt eine BCRYPT_MULTI_OBJECT_LENGTH_STRUCT zurück, die Informationen enthält, die zum Berechnen der Größe eines Objektpuffers erforderlich sind. Diese Eigenschaft wird nur in Betriebssystemversionen unterstützt, die die BCryptCreateMultiHash-Funktion unterstützen.

BCRYPT_OBJECT_LENGTH

L"ObjectLength"

Die Größe des Unterobjekts eines Anbieters in Bytes. Dieser Datentyp ist ein DWORD. Derzeit verwenden die Anbieter des Hash- und symmetrischen Verschlüsselungsalgorithmus aufrufergeteilte Puffer, um ihre Unterobjekte zu speichern. Beispielsweise erfordert der Hashanbieter, dass Sie Speicher für das Hashobjekt zuweisen, das mit der BCryptCreateHash-Funktion abgerufen wurde. Diese Eigenschaft stellt die Puffergröße für das Objekt eines Anbieters bereit, sodass Sie Speicher für das vom Anbieter erstellte Objekt zuordnen können.

BCRYPT_PADDING_SCHEMES

L"PaddingSchemes"

Stellt das Abstandsschema des RSA-Algorithmusanbieters dar. Dieser Datentyp ist ein DWORD. Dies kann einer der folgenden Werte sein:

Kennung	Wert	BESCHREIBUNG
BCRYPT_SUPPORTED_PAD_ROUTER	0x00000001	Der Anbieter unterstützt den vom Router hinzugefügten Abstand.
BCRYPT_SUPPORTED_PAD_PKCS1_ENC	0x00000002	Der Anbieter unterstützt das PKCS1-Verschlüsselungsabstandsschema.
BCRYPT_SUPPORTED_PAD_PKCS1_SIG	0x00000004	Der Anbieter unterstützt das PKCS1-Signaturabstandsschema.
BCRYPT_SUPPORTED_PAD_OAEP	0x00000008	Der Anbieter unterstützt das OAEP-Abstandsschema.
BCRYPT_SUPPORTED_PAD_PSS	0x00000010	Der Anbieter unterstützt das PSS-Abstandsschema.

BCRYPT_PARAMETER_SET_NAME

L"ParameterSetName"

Dieser Bezeichner muss für BCrypt ML-DSA und ML-KEM Schlüssel festgelegt werden, bevor sie abgeschlossen werden können. Die Eigenschaft kann auf einen der folgenden Werte festgelegt werden.

PQ-DSA Eigenschaftswerte für BCRYPT_PARAMETER_SET_NAME:

Kennung	Wert
BCRYPT_MLDSA_PARAMETER_SET_44	L"44"
BCRYPT_MLDSA_PARAMETER_SET_65	L"65"
BCRYPT_MLDSA_PARAMETER_SET_87	L"87"

ML-KEM Eigenschaftswerte für BCRYPT_PARAMETER_SET_NAME:

Kennung	Wert
BCRYPT_MLKEM_PARAMETER_SET_512	L"512"
BCRYPT_MLKEM_PARAMETER_SET_768	L"768"
BCRYPT_MLKEM_PARAMETER_SET_1024	L"1024"

BCRYPT_PROVIDER_HANDLE

L"ProviderHandle"

Das Handle des CNG-Anbieters, der das objekt erstellt hat, das im hObject-Parameter übergeben wurde. Dieser Datentyp ist ein BCRYPT_ALG_HANDLE. Diese Eigenschaft kann nur abgerufen werden. sie kann nicht festgelegt werden.

BCRYPT_SIGNATURE_LENGTH

L"SignatureLength"

Die Größe in Byte der Länge einer Signatur für einen Schlüssel. Dieser Datentyp ist ein DWORD. Diese Eigenschaft gilt nur für Schlüssel. Diese Eigenschaft kann nur abgerufen werden. sie kann nicht festgelegt werden.

Anforderungen

Verwandte Inhalte

CNG-Algorithmus-Pseudohandles

CNG-Algorithmusbezeichner