Share via

ICspInformation::GetCspStatusFromOperations-Methode (certenroll.h)

  • Artikel

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.

Rückgabecode/-wert BESCHREIBUNG
CERTSRV_E_PROPERTY_EMPTY
 Das ICspStatus-Objekt konnte nicht gefunden werden.
OLE_E_BLANK
 Das ICspInformation-Objekt wurde nicht initialisiert.

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

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

ICspInformation