IObjectId::GetAlgorithmName-Methode (certenroll.h)

2023-08-22

Die GetAlgorithmName-Methode ruft den Anzeigenamen ab, der einem Algorithmusobjektbezeichner (OID) zugeordnet ist.

Syntax

HRESULT GetAlgorithmName(
  [in]  ObjectIdGroupId        GroupId,
  [in]  ObjectIdPublicKeyFlags KeyFlags,
  [out] BSTR                   *pstrAlgorithmName
);

Parameter

[in] GroupId

Ein ObjectIdGroupId-Enumerationswert , der die zu durchsuchende OID-Gruppe angibt. Dies kann eine der folgenden Algorithmusgruppen sein:

XCN_CRYPT_HASH_ALG_OID_GROUP_ID
XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID
XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID
XCN_CRYPT_SIGN_ALG_OID_GROUP_ID

Darüber hinaus können Sie auch Gruppen angeben, die keine kryptografischen Algorithmen enthalten:

XCN_CRYPT_RDN_ATTR_OID_GROUP_ID
XCN_CRYPT_EXT_OR_ATTR_OID_GROUP_ID
XCN_CRYPT_ENHKEY_USAGE_OID_GROUP_ID
XCN_CRYPT_POLICY_OID_GROUP_ID
XCN_CRYPT_TEMPLATE_OID_GROUP_ID

[in] KeyFlags

Ein ObjectIdPublicKeyFlags-Enumerationswert , der angibt, ob nach einem Signatur- oder verschlüsselungsalgorithmus gesucht werden soll. Mögliche Werte:

XCN_CRYPT_OID_INFO_PUBKEY_ANY
XCN_CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
XCN_CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG

Sie können einen der letzten beiden Werte verwenden, um Zwischenalgorithmen wie RSA zu unterscheiden, die zum Verschlüsseln und Signieren von Nachrichten verwendet werden können. Sie müssen auch XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID im GroupId-Parameter angeben. Geben Sie XCN_CRYPT_OID_INFO_PUBKEY_ANY an, wenn Sie den GroupId-Parameter auf etwas anderes als XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID festlegen.

[out] pstrAlgorithmName

Zeiger auf eine BSTR-Variable , die den Namen enthält.

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
CERTSRV_E_PROPERTY_EMPTY	Die Zeichenfolge, die den Algorithmusnamen enthält, ist leer.
OLE_E_BLANK	Der Algorithmusname konnte nicht gefunden werden. Sie müssen InitializeFromAlgorithmName aufrufen, bevor Sie GetAlgorithmName aufrufen.

Hinweise

Sie können die XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID Konstante verwenden, um einen GroupId-Parameterwert zu erstellen, der die Schlüsselgröße für Algorithmen berücksichtigt, die durch eine variable Bitlänge identifiziert werden können. Um beispielsweise ein IObjectId-Objekt aus einem 192-Bit-AES-Algorithmus zu initialisieren, geben Sie "AES" für den strAlgorithmName-Parameter an, verschieben Sie die Länge nach links um 16, und führen Sie eine bitweise OR-Kombination für die verschobene Bitlänge und XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID aus.

Wenn Sie den GroupId-Parameter auf etwas anderes als XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID festlegen, geben Sie XCN_CRYPT_OID_INFO_PUBKEY_ANY für den KeyFlags-Parameter an.

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

IObjectId

Freigeben über