ICspInformation::GetCspStatusFromOperations-Methode (certenroll.h)

Die GetCspStatusFromOperations-Methode erstellt ein ICspStatus-Objekt für den ersten unterstützten Algorithmus, das mit dem angegebenen Signatur-, Verschlüsselungs-, Hashing- oder Verschlüsselungsvorgang konsistent ist.

Syntax

HRESULT GetCspStatusFromOperations(
  [in, optional] IObjectId               *pAlgorithm,
  [in]           AlgorithmOperationFlags Operations,
  [out]          ICspStatus              **ppValue
);

Parameter

[in, optional] pAlgorithm

Zeiger auf eine IObjectId-Schnittstelle , die eine Algorithmus-OID darstellt. Dieser Parameter ist optional und kann NULL sein.

• Wenn Sie eine OID angeben und den Operations-Parameter auf XCN_NCRYPT_SIGNATURE_OPERATION festlegen und dieses Flag mit XCN_NCRYPT_EXACT_MATCH_OPERATION oder XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION kombinieren, wird ggf. der erste Signaturalgorithmus verwendet, der der OID entspricht.
• Wenn Sie eine OID angeben, den Operations-Parameter aber nicht auf XCN_NCRYPT_SIGNATURE_OPERATION festlegen oder XCN_NCRYPT_SIGNATURE_OPERATION festlegen, ihn aber nicht mit XCN_NCRYPT_EXACT_MATCH_OPERATION oder XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION kombinieren, wird der erste Algorithmus verwendet, der zum Signieren oder Verschlüsseln verwendet werden kann.
• Wenn Sie keine OID angeben, wird der erste unterstützte Algorithmus verwendet, der den im Operations-Parameter angegebenen Flags entspricht.

[in] Operations

Ein AlgorithmOperationFlags-Enumerationswert , der den Typ des abzurufenden Algorithmus angibt. Einer der folgenden Werte muss angegeben werden:

• XCN_NCRYPT_CIPHER_OPERATION
• XCN_NCRYPT_HASH_OPERATION
• XCN_NCRYPT_SIGNATURE_OPERATION
• XCN_NCRYPT_SECRET_AGREEMENT_OPERATION
• XCN_NCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION

Sie können die Suchmerkmale verfeinern, indem Sie eines der vorherigen Flags mit einem der folgenden Flags kombinieren:

• XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION
• XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION
• XCN_NCRYPT_EXACT_MATCH_OPERATION

Wenn Sie die XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION- oder XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION-Einstellungsflags festlegen, können Sie auch keines der folgenden Flags angeben:

• XCN_NCRYPT_CIPHER_OPERATION
• XCN_NCRYPT_HASH_OPERATION

[out] ppValue

Adresse einer Variablen, die einen Zeiger auf eine ICspStatus-Schnittstelle empfängt.

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.

Hinweise

Ein ICspStatus-Objekt enthält status Informationen zu einem Kryptografieanbieter. Jedes Objekt wird für einen bestimmten Algorithmus initialisiert, der vom Anbieter unterstützt wird. Wenn Sie keinen Algorithmus im pAlgorithm-Parameter angeben, wird der erste unterstützte Algorithmus, der mit den zulässigen Vorgängen konsistent ist, ausgewählt, um das ICspStatus-Objekt zu erstellen.

Anforderungen

Weitere Informationen

ICspInformation