IX509PrivateKey::Create-Methode (certenroll.h)
Die Create-Methode erstellt einen asymmetrischen privaten Schlüssel.
Syntax
HRESULT Create();
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.
Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Das CSP-Handle ist nicht NULL. |
|
Der Schlüssel ist bereits vorhanden. |
Hinweise
Wenn Sie die Eigenschaften CspStatus, ProviderName oder ProviderType nicht festlegen, verwendet diese Methode beim Erstellen des Schlüssels die Standardwerte provider, key size und KeySpec . Bei einer neuen Betriebssysteminstallation ist z. B. Microsoft Enhanced Cryptographic Provider v1.0 der Standardanbieter.
Wenn Sie die ContainerName-Eigenschaft nicht festlegen, generiert diese Methode automatisch einen Namen. Der generierte Name enthält eine GUID und, wenn die ContainerNamePrefix-Eigenschaft nicht festgelegt ist, das Präfix "lp-". Wenn der Anbieter ein intelligenter Karte-Anbieter ist, überschreitet der generierte Name nicht den vom Anbieter angegebenen MaxKeyContainerNameLength-Wert. Wenn der generierte Name diesen Wert anfänglich überschreitet, wird er auf vierzig Zeichen abgeschnitten.
Sie können die folgenden Eigenschaften nach dem Aufrufen der Create- oder Open-Methode nicht festlegen. Wenn Sie sie angeben möchten, müssen Sie dies tun, bevor Sie eine dieser Methoden aufrufen.
- Algorithmus
- ContainerName
- ContainerNamePrefix
- CspInformations
- CspStatus
- Beschreibung
- Vorhanden
- ExportPolicy
- Friendlyname
- KeyProtection
- KeySpec
- KeyUsage
- LegacyCsp
- Länge
- MachineContext
- ProviderName
- ProviderType
- Pin
- ReaderName
- Leise
- UIContextMessage
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | certenroll.h |
| DLL | CertEnroll.dll |