IX509CertificateRequest ::GetInnerRequest, méthode (certenroll.h)

Article
03/14/2023

La méthode GetInnerRequest récupère un objet de requête imbriqué.

Syntaxe

HRESULT GetInnerRequest(
  [in]  InnerRequestLevel       Level,
  [out] IX509CertificateRequest **ppValue
);

Paramètres

[in] Level

Valeur d’une énumération InnerRequestLevel qui spécifie le niveau d’enveloppement des données à récupérer. Vous pouvez utiliser la valeur LevelNext pour itérer au sein des niveaux imbriqués ou la valeur LevelInnermost pour récupérer l’objet de requête le plus profondément imbriqué. Vous ne pouvez pas spécifier LevelNext pour une requête PKCS #10.

[out] ppValue

Adresse d’une variable qui reçoit un pointeur vers une interface IX509CertificateRequest qui contient la requête imbriquée. Appelez la propriété Type pour déterminer si l’objet de requête interne est une requête PKCS #10 ou CMC. Appelez ensuite QueryInterface pour récupérer le pointeur approprié.

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	Vous avez spécifié une valeur de requête LevelNext PKCS #10.

Remarques

Un objet de requête de niveau supérieur peut être une requête PKCS #10, PKCS #7 ou CMC. Les règles suivantes s’appliquent aux objets de requête internes :

Une requête PKCS #10 ne peut pas contenir d’objet de requête interne.
Une requête PKCS #7 ne peut contenir qu’un objet de requête interne PKCS #10.
Une requête CMC peut contenir un objet de requête interne CMC ou PKCS #10. Pour une requête CMC qui contient une requête CMC interne, il n’existe aucune limite théorique au nombre de niveaux imbriqués pouvant exister avant que la requête PKCS #10 interne finale soit atteinte. Autrement dit, une requête CMC de niveau supérieur peut contenir une requête CMC interne qui contient également une requête CMC interne, etc.

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