Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
NCryptSetProperty con Key Storage Provider (KSP)
La NCryptSetProperty funzione imposta i valori delle proprietà per un oggetto di archiviazione delle chiavi.
Parametri
-
hObject[in] -
La maniglia dell'oggetto di cui si desidera impostare la proprietà. È possibile utilizzare:
-
Un provider handle (
NCRYPT_PROV_HANDLE) -
Una maniglia chiave (
NCRYPT_KEY_HANDLE)
-
-
pszProperty[in] -
Un puntatore a una stringa Unicode con terminazione nulla contenente il nome della proprietà da recuperare.
Quando si utilizza
NCRYPT_PROV_HANDLE, AWS CloudHSM Key Storage Provider (KSP) supporta i seguenti identificatori KSP:Identificatore/valore Descrizione NCRYPT_USE_CONTEXT_PROPERTY
«Usa contesto»
Un puntatore a una stringa Unicode con terminazione nulla che descrive il contesto dell'operazione.
Quando viene utilizzato
NCRYPT_KEY_HANDLE, AWS CloudHSM Key Storage Provider (KSP) supporta i seguenti identificatori KSP:Identificatore/valore Descrizione NCRYPT_KEY_USAGE_PROPERTY
«Utilizzo delle chiavi»
Un DWORD contenente una serie di flag che definiscono i dettagli di utilizzo delle chiavi. Questa proprietà si applica solo alle chiavi. Può contenere zero o una combinazione di uno o più dei seguenti valori.
NCRYPT_ALLOW_DECRYPT_FLAG (0x00000001)
NCRYPT_ALLOW_SIGNING_FLAG (0x00000002)
NCRYPT_LENGTH_PROPERTY
«Lunghezza»
Un DWORD contenente la lunghezza della chiave in bit.
NCRYPT_EXPORT_POLICY_PROPERTY
«Politica di esportazione»
Un DWORD contenente flag che specificano la politica di esportazione della chiave persistente. Questo può contenere zero o una combinazione di uno o più dei seguenti valori.
NCRYPT_ALLOW_EXPORT_FLAG (0x00000001)
Nota
I valori sono stringhe letterali a caratteri larghi, come indicato da L prima del valore letterale.
-
pbInput[in] -
L'indirizzo di un buffer che contiene il nuovo valore della proprietà.
cbInputcontiene la dimensione del buffer. -
cbInput[in] -
La dimensione del
pbInputbuffer in byte. dwFlags[in]-
Bandiere che modificano il comportamento della funzione. Nessun flag è definito per questa funzione.
Valore restituito
La funzione restituisce un codice di stato per indicare l'esito positivo o negativo.
I codici di restituzione comuni includono:
| Codice di restituzione | Descrizione |
|---|---|
|
ERROR_SUCCESS |
L'operazione è stata completata con successo. |
|
NTE_INVALID_PARAMETER |
Uno o più parametri non sono validi. |
|
NOTE_FAIL |
L'operazione non è stata completata. |
|
NET_BAD_FLAGS |
Il |
|
NOT_NOT_SUPPORTED |
Il |
|
NTE_INVALID_HANDLE |
L'handle in non è valido. |
|
NET_BAD_DATA |
I dati indicati da |
