IX509CertificateRequest ::GetInnerRequest, méthode (certenroll.h)
La méthode GetInnerRequest récupère un objet de requête imbriqué.
HRESULT GetInnerRequest(
[in] InnerRequestLevel Level,
[out] IX509CertificateRequest **ppValue
);
[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é.
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 |
---|---|
|
Vous avez spécifié une valeur de requête LevelNext PKCS #10. |
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.
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 |