Condividi tramite


Identificatori di proprietà primitive di crittografia

I valori seguenti vengono usati con le funzioni BCryptGetProperty e BCryptSetProperty per identificare una proprietà.

BCRYPT_ALGORITHM_NAME

L"AlgorithmName"

Stringa Unicode con terminazione Null contenente il nome dell'algoritmo.

BCRYPT_AUTH_TAG_LENGTH

L"AuthTagLength"

Lunghezze dei tag di autenticazione supportate dall'algoritmo. Questa proprietà è una struttura BCRYPT_AUTH_TAG_LENGTHS_STRUCT . Questa proprietà si applica solo agli algoritmi.

BCRYPT_BLOCK_LENGTH

L"BlockLength"

Dimensione, in byte, di un blocco di crittografia per l'algoritmo. Questa proprietà si applica solo agli algoritmi di crittografia a blocchi. Questo tipo di dati è DWORD.

BCRYPT_BLOCK_SIZE_LIST

L"BlockSizeList"

Elenco delle lunghezze dei blocchi supportate da un algoritmo di crittografia. Questo tipo di dati è una matrice di DWORD. Il numero di elementi nella matrice può essere determinato dividendo il numero di byte recuperati dalla dimensione di un singolo DWORD.

BCRYPT_CHAINING_MODE

L"ChainingMode"

Puntatore a una stringa Unicode con terminazione Null che rappresenta la modalità di concatenamento dell'algoritmo di crittografia. Questa proprietà può essere impostata su un handle di algoritmo o un handle di chiave su uno dei valori seguenti.

Identificatore Valore Descrizione
BCRYPT_CHAIN_MODE_CBC L"ChainingModeCBC"
Imposta la modalità di concatenamento dell'algoritmo sul concatenamento del blocco crittografato.
BCRYPT_CHAIN_MODE_CCM L"ChainingModeCCM"
Imposta la modalità di concatenamento dell'algoritmo per eseguire il contatore con la modalità CBC-MAC (CCM). Windows Vista: Questo valore è supportato a partire da Windows Vista con SP1.

BCRYPT_CHAIN_MODE_CFB L"ChainingModeCFB"
Imposta la modalità di concatenamento dell'algoritmo per il feedback crittografato.
BCRYPT_CHAIN_MODE_ECB L"ChainingModeECB"
Imposta la modalità di concatenamento dell'algoritmo sul codebook elettronico.
BCRYPT_CHAIN_MODE_GCM L"ChainingModeGCM"
Imposta la modalità di concatenamento dell'algoritmo su Galois/modalità contatore (GCM). Windows Vista: Questo valore è supportato a partire da Windows Vista con SP1.

BCRYPT_CHAIN_MODE_NA L"ChainingModeN/A"
L'algoritmo non supporta il concatenamento.

BCRYPT_DH_PARAMETERS

L"DHParameters"

Specifica i parametri da usare con una chiave Diffie-Hellman. Questo tipo di dati è un puntatore a una struttura BCRYPT_DH_PARAMETER_HEADER . Questa proprietà può essere impostata solo e deve essere impostata per la chiave prima del completamento della chiave.

BCRYPT_DSA_PARAMETERS

L"DSAParameters"

Specifica i parametri da usare con una chiave DSA. Questa proprietà è una BCRYPT_DSA_PARAMETER_HEADER o una struttura BCRYPT_DSA_PARAMETER_HEADER_V2 . Questa proprietà può essere impostata solo e deve essere impostata per la chiave prima del completamento della chiave.

Windows 8: a partire da Windows 8, questa proprietà può essere una struttura BCRYPT_DSA_PARAMETER_HEADER_V2. Utilizzare questa struttura se le dimensioni della chiave superano i 1024 bit ed è minore o uguale a 3072 bit. Se la dimensione della chiave è maggiore o uguale a 512 ma minore o uguale a 1024 bit, usare la struttura BCRYPT_DSA_PARAMETER_HEADER .

BCRYPT_EFFECTIVE_KEY_LENGTH

L"EffectiveKeyLength"

Dimensioni, in bit, della lunghezza effettiva di una chiave RC2. Questo tipo di dati è DWORD.

BCRYPT_HASH_BLOCK_LENGTH

L"HashBlockLength"

Dimensione, in byte, del blocco per un hash. Questa proprietà si applica solo agli algoritmi hash. Questo tipo di dati è DWORD.

BCRYPT_HASH_LENGTH

L"HashDigestLength"

Dimensione, in byte, del valore hash di un provider hash. Questo tipo di dati è DWORD.

BCRYPT_HASH_OID_LIST

L"HashOIDList"

Elenco di identificatori OID (Hashing object identifier) con codifica DER. Questa proprietà è una struttura BCRYPT_OID_LIST . Questa proprietà può essere letta solo.

BCRYPT_INITIALIZATION_VECTOR

L"IV"

Contiene il vettore di inizializzazione (IV) per una chiave. Questa proprietà si applica solo alle chiavi.

BCRYPT_KEY_LENGTH

L"KeyLength"

Dimensione, in bit, del valore della chiave di un provider di chiavi simmetriche. Questo tipo di dati è DWORD.

BCRYPT_KEY_LENGTHS

L"KeyLengths"

Lunghezze di chiave supportate dall'algoritmo. Questa proprietà è una struttura BCRYPT_KEY_LENGTHS_STRUCT . Questa proprietà si applica solo agli algoritmi.

BCRYPT_KEY_OBJECT_LENGTH

L"KeyObjectLength"

Questa proprietà non viene utilizzata. La proprietà BCRYPT_OBJECT_LENGTH viene utilizzata per ottenere queste informazioni.

BCRYPT_KEY_STRENGTH

L"KeyStrength"

Numero di bit nella chiave. Questo tipo di dati è DWORD. Questa proprietà si applica solo alle chiavi.

BCRYPT_MESSAGE_BLOCK_LENGTH

L"MessageBlockLength"

Questa opzione può essere impostata su qualsiasi handle di chiave con la modalità di concatenamento DELL'OGGETTO. Per impostazione predefinita, questa proprietà è impostata su 1 per l'opzione CRITERI a 8 bit. Impostandolo sulla dimensione del blocco in byte, viene utilizzato IL BLOCCO INTERO. Per le chiavi XTS viene usato per impostare le dimensioni, in byte, dell'unità dati XTS (in genere 512 o 4096).

BCRYPT_MULTI_OBJECT_LENGTH

L"MultiObjectLength"

Questa proprietà restituisce un BCRYPT_MULTI_OBJECT_LENGTH_STRUCT, che contiene informazioni necessarie per calcolare le dimensioni di un buffer di oggetti. Questa proprietà è supportata solo nelle versioni del sistema operativo che supportano la funzione BCryptCreateMultiHash .

BCRYPT_OBJECT_LENGTH

L"ObjectLength"

Dimensione, in byte, del sottooggetto di un provider. Questo tipo di dati è DWORD. Attualmente, i provider di algoritmi di crittografia hash e simmetrica usano buffer allocati dal chiamante per archiviare i relativi oggetti secondari. Ad esempio, il provider hash richiede di allocare memoria per l'oggetto hash ottenuto con la funzione BCryptCreateHash . Questa proprietà fornisce le dimensioni del buffer per l'oggetto di un provider in modo da poter allocare memoria per l'oggetto creato dal provider.

BCRYPT_PADDING_SCHEMES

L"PaddingSchemes"

Rappresenta lo schema di spaziatura interna del provider di algoritmi RSA. Questo tipo di dati è DWORD. Può trattarsi di uno dei valori seguenti.

Identificatore Valore Descrizione
BCRYPT_SUPPORTED_PAD_ROUTER 0x00000001 Il provider supporta la spaziatura interna aggiunta dal router.
BCRYPT_SUPPORTED_PAD_PKCS1_ENC 0x00000002 Il provider supporta lo schema di spaziatura interna della crittografia PKCS1.
BCRYPT_SUPPORTED_PAD_PKCS1_SIG 0x00000004 Il provider supporta lo schema di spaziatura interna della firma PKCS1.
BCRYPT_SUPPORTED_PAD_OAEP 0x00000008 Il provider supporta lo schema di spaziatura interna OAEP.
BCRYPT_SUPPORTED_PAD_PSS 0x00000010 Il provider supporta lo schema di spaziatura interna PSS.

BCRYPT_PROVIDER_HANDLE

L"ProviderHandle"

Handle del provider CNG che ha creato l'oggetto passato nel parametro hObject . Questo tipo di dati è un BCRYPT_ALG_HANDLE. Questa proprietà può essere recuperata solo; non può essere impostata.

BCRYPT_SIGNATURE_LENGTH

L"SignatureLength"

Dimensione, in byte, della lunghezza di una firma per una chiave. Questo tipo di dati è DWORD. Questa proprietà si applica solo alle chiavi. Questa proprietà può essere recuperata solo; non può essere impostata.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2008 [solo app desktop]
Intestazione
Bcrypt.h