Freigeben über

ICspAlgorithm::GetAlgorithmOid-Methode (certenroll.h)

  • Artikel

Die GetAlgorithmOid-Methode ruft den Algorithmus-Objektbezeichner (OID) ab. Diese Methode ist webfähig.

Syntax

HRESULT GetAlgorithmOid(
  [in]  LONG           Length,
  [in]  AlgorithmFlags AlgFlags,
  [out] IObjectId      **ppValue
);

Parameter

[in] Length

Eine LONG-Variable , die die erforderliche Schlüsselgröße des symmetrischen Verschlüsselungsalgorithmus identifiziert. Verwenden Sie diesen Parameter, um einen bestimmten AES-Algorithmus aus einer Kryptografie-API abzurufen: Schlüsselspeicheranbieter der nächsten Generation (CNG). Ein KSP kann nur einen Algorithmus namens AES auflisten, unterstützt aber alle AES-Varianten in der folgenden Liste:

  • szOID_NIST_AES128_CBC (2.16.840.1.101.3.4.1.2)
  • szOID_NIST_AES192_CBC (2.16.840.1.101.3.4.1.22)
  • szOID_NIST_AES256_CBC (2.16.840.1.101.3.4.1.42)
  • szOID_NIST_AES128_WRAP (2.16.840.1.101.3.4.1.5)
  • szOID_NIST_AES192_WRAP (2.16.840.1.101.3.4.1.25)
  • szOID_NIST_AES256_WRAP (2.16.840.1.101.3.4.1.45)

Wenn Sie null für den Length-Parameter und AlgorithmFlagsNone (0x00000000) für den AlgFlags-Parameter angeben, wird die dem Standardalgorithmus zugeordnete OID abgerufen. Für microsoft Software KSP und Microsoft Smart Card KSP ist der AES-Standardalgorithmus szOID_NIST_AES128_CBC (2.16.840.1.101.3.4.1.2).

Hinweis Dieser Parameter muss für jeden anderen Algorithmus als einen symmetrischen Verschlüsselungsalgorithmus null sein.

 

[in] AlgFlags

Ein AlgorithmFlags-Enumerationswert , der angibt, ob nach einem Schlüsselumbruchalgorithmus gesucht werden soll. Mögliche Werte:

  • AlgorithmFlagsNone
  • AlgorithmFlagsWrap

Die Angabe von AlgorithmFlagsWrap bewirkt, dass diese Methode nach Algorithmen sucht, für die der Anzeigename mit "wrap" endet. Dies umfasst die folgenden OIDs:

  • szOID_NIST_AES128_WRAP (2.16.840.1.101.3.4.1.5)
  • szOID_NIST_AES192_WRAP (2.16.840.1.101.3.4.1.25)
  • szOID_NIST_AES256_WRAP (2.16.840.1.101.3.4.1.45)
  • XCN_OID_RSA_SMIMEalgCMS3DESwrap (1.2.840.113549.1.9.16.3.6)
  • XCN_OID_RSA_SMIMEalgCMSRC2wrap (1.2.840.113549.1.9.16.3.7)

Wenn Sie null für den Length-Parameter und AlgorithmFlagsNone (0x00000000) für den AlgFlags-Parameter angeben, wird die dem Standardalgorithmus zugeordnete OID abgerufen. Für microsoft Software KSP und Microsoft Smart Card KSP ist der AES-Standardalgorithmus szOID_NIST_AES128_CBC (2.16.840.1.101.3.4.1.2).

Hinweis Dieser Parameter muss für jeden anderen Algorithmus als einen symmetrischen Verschlüsselungsalgorithmus null sein.

 

[out] ppValue

Adresse einer Variablen, die einen Zeiger auf eine IObjectId-Schnittstelle empfängt, die die Algorithmus-OID darstellt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, 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
CERTSRV_E_PROPERTY_EMPTY
 Die Algorithmus-OID konnte nicht gefunden werden.
OLE_E_BLANK
 Die CSP-Informationen wurden nicht initialisiert. Weitere Informationen finden Sie unter ICspInformation-Schnittstelle .

Hinweise

Sie müssen die InitializeFromName-Methode oder die InitializeFromType-Methode auf der ICspInformation-Schnittstelle aufrufen, bevor Sie GetAlgorithmOid aufrufen.

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

Weitere Informationen

ICspAlgorithm