

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# NCryptCreatePersistedKey mit Key Storage Provider (KSP)
<a name="ksp-library-apis-create-persisted-key"></a>

Die `NCryptCreatePersistedKey` Funktion erstellt einen neuen Schlüssel und speichert ihn im Key Storage Provider (KSP). Sie können die [`NCryptSetProperty`](ksp-library-apis-set-property.md)Funktion verwenden, um ihre Eigenschaften nach der Erstellung festzulegen. Sie müssen anrufen, [`NCryptFinalizeKey`](ksp-library-apis-finalize-key.md)bevor Sie den Schlüssel verwenden können.

## Parameters
<a name="ksp-library-apis-create-persisted-key-parameters"></a>

 `hProvider`[rein]   
Das Handle des Schlüsselspeicheranbieters, unter dem Sie den Schlüssel erstellen werden. Verwenden Sie [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md), um dieses Handle zu erhalten.

 `phKey`[raus]   
Die Adresse einer `NCRYPT_KEY_HANDLE` Variablen, die das Schlüssel-Handle speichert. 

 `pszAlgId`[in]   
Ein Zeiger auf eine mit Null terminierte Unicode-Zeichenfolge, die den Bezeichner des kryptografischen Algorithmus für die Erstellung des Schlüssels angibt.  
AWS CloudHSM Der Key Storage Provider (KSP) unterstützt die folgenden Algorithmen:     
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

`pszKeyName`[rein, optional]  
Ein Zeiger auf eine Unicode-Zeichenfolge mit Nullterminierung, die den Namen des Schlüssels enthält. Wenn dieser Parameter NULL ist, erstellt diese Funktion einen kurzlebigen Schlüssel, der nicht persistent ist.

`dwLegacyKeySpec`[in, unbenutzt]  
AWS CloudHSM Key Storage Provider (KSP) verwendet diesen Parameter nicht.

`dwFlags`[in]  
Flags, um das Verhalten der Funktion zu ändern. Verwenden Sie null oder mehr der folgenden Werte:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

## Rückgabewert
<a name="ksp-library-apis-create-persisted-key-return-value"></a>

Die Funktion gibt einen Statuscode zurück, der auf Erfolg oder Misserfolg hinweist.

Zu den gängigen Rückgabecodes gehören:


****  

| Rückgabecode | Description | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  Die Funktion wurde erfolgreich abgeschlossen.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Ein oder mehrere Parameter sind nicht gültig.  | 
|  NET\$1FAIL  |  Der Vorgang konnte nicht abgeschlossen werden.  | 
|  NET\$1BAD\$1FLAGS  |  Der `dwFlags` Parameter enthält einen ungültigen Wert.  | 
|  NTE\$1NOT\$1SUPPORTED  |  Der `pszAlgId` Parameter enthält einen Wert, der nicht unterstützt wird.  | 
|  NTE\$1EXISTS  |  Ein Schlüssel mit dem angegebenen Namen ist bereits vorhanden und der Vorgang wurde nicht verwendet. ` NCRYPT_OVERWRITE_KEY_FLAG`  | 