NCryptSetPropertycon Key Storage Provider (KSP) - AWS CloudHSM

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à.

NCryptSetPropertycon 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 utilizzaNCRYPT_PROV_HANDLE, AWS CloudHSM Key Storage Provider () supporta i seguenti identificatori: KSP 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 si utilizzaNCRYPT_KEY_HANDLE, AWS CloudHSM Key Storage Provider () supporta i seguenti identificatori: KSP KSP

Identificatore/valore Descrizione

NCRYPT_KEY_USAGE_PROPERTY

«Utilizzo delle chiavi»

A DWORD contenente una serie di flag che definiscono i dettagli chiave di utilizzo. 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 _ (0x00000002SIGNING) FLAG

NCRYPT_LENGTH_PROPERTY

«Lunghezza»

A DWORD contenente la lunghezza della chiave in bit.

NCRYPT_EXPORT_POLICY_PROPERTY

«Politica di esportazione»

A 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 pbInput buffer 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.

NTE_FAIL

L'operazione non è stata completata.

NTE_BAD_FLAGS

Il dwFlags parametro contiene un valore non valido.

NTE_NOT_SUPPORTED

Il pszProperty parametro contiene un valore non supportato.

NTE_INVALID_HANDLE

L'handle in non hObject è valido.

NTE_BAD_DATA

I dati indicati da pbInput e non cbInput sono validi.