Méthode ICspInformation ::GetCspStatusFromOperations (certenroll.h)

Article
08/22/2023

La méthode GetCspStatusFromOperations crée un objet ICspStatus pour le premier algorithme pris en charge qui est cohérent avec l’opération de signature, de chiffrement, de hachage ou de chiffrement spécifiée.

Syntaxe

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

Paramètres

[in, optional] pAlgorithm

Pointeur vers une interface IObjectId qui représente un OID d’algorithme. Ce paramètre est facultatif et peut être NULL.

Si vous spécifiez un OID et définissez le paramètre Operations sur XCN_NCRYPT_SIGNATURE_OPERATION et que vous combinez cet indicateur avec XCN_NCRYPT_EXACT_MATCH_OPERATION ou XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION, le premier algorithme de signature, le cas échéant, qui correspond à l’OID est utilisé.
Si vous spécifiez un OID mais que vous ne définissez pas le paramètre Operations sur XCN_NCRYPT_SIGNATURE_OPERATION, ou si vous définissez XCN_NCRYPT_SIGNATURE_OPERATION mais ne le combinez pas avec XCN_NCRYPT_EXACT_MATCH_OPERATION ou XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION, le premier algorithme qui peut être utilisé pour la signature ou le chiffrement est utilisé.
Si vous ne spécifiez pas d’OID, le premier algorithme pris en charge cohérent avec les indicateurs spécifiés dans le paramètre Operations est utilisé.

[in] Operations

Valeur d’énumération AlgorithmOperationFlags qui identifie le type d’algorithme à récupérer. L’une des valeurs suivantes doit être spécifiée :

XCN_NCRYPT_CIPHER_OPERATION
XCN_NCRYPT_HASH_OPERATION
XCN_NCRYPT_SIGNATURE_OPERATION
XCN_NCRYPT_SECRET_AGREEMENT_OPERATION
XCN_NCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION

Vous pouvez affiner les caractéristiques de recherche en combinant l’un des indicateurs précédents avec l’un des éléments suivants :

XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION
XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION
XCN_NCRYPT_EXACT_MATCH_OPERATION

Si vous définissez les indicateurs de préférence XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION ou XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION, vous ne pouvez pas également spécifier l’un des éléments suivants :

XCN_NCRYPT_CIPHER_OPERATION
XCN_NCRYPT_HASH_OPERATION

[out] ppValue

Adresse d’une variable qui reçoit un pointeur vers une interface ICspStatus .

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code/valeur de retour	Description
CERTSRV_E_PROPERTY_EMPTY	L’objet ICspStatus est introuvable.
OLE_E_BLANK	L’objet ICspInformation n’a pas été initialisé.

Remarques

Un objet ICspStatus contient status informations sur un fournisseur de chiffrement. Chaque objet est initialisé pour un algorithme spécifique pris en charge par le fournisseur. Si vous ne spécifiez pas d’algorithme dans le paramètre pAlgorithm , le premier algorithme pris en charge cohérent avec les opérations autorisées est choisi pour créer l’objet ICspStatus .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certenroll.h
DLL	CertEnroll.dll

Voir aussi

ICspInformation

Partager via