ICertRequest ::GetLastStatus, méthode (certcli.h)
La méthode GetLastStatus obtient le dernier code de retour pour cette requête. Cela retourne les informations de code d’erreur, plutôt que la suppression de la demande.
Syntaxe
HRESULT GetLastStatus(
[out] LONG *pStatus
);
Paramètres
[out] pStatus
Pointeur vers le code status de la demande.
Valeur retournée
C++
Si la méthode réussit, la méthode retourne S_OK.Une fois cette fonction terminée, *pStatus est défini sur le code de résultat du dernier appel à ICertRequest3 ::Submit, ICertRequest3 ::RetrievePending ou ICertRequest3 ::GetCACertificate.
Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
VB
La valeur de retour est le code de résultat du dernier appel à CCertRequest3.Submit, CCertRequest3.RetrievePending ou CCertRequest3.GetCACertificate.Remarques
La valeur récupérée par GetLastStatus dépend de l’appel le plus récent à ICertRequest3 ::Submit, ICertRequest3 ::RetrievePending ou ICertRequest3 ::GetCACertificate. Si un appel à l’une de ces méthodes échoue sur le serveur, appelez GetLastStatus pour récupérer le numéro d’erreur. Certaines défaillances de serveur (telles que les demandes refusées) retournent S_OK et une disposition autre que CR_DISP_ISSUED de l’appel de méthode, et vous pouvez utiliser GetLastStatus pour récupérer la cause spécifique de l’échec. Si un appel à l’une de ces méthodes réussit, un appel suivant à GetLastStatus retourne S_OK (qui est égal à zéro).
En outre, la suppression de la demande est stockée dans la base de données des services de certificats et peut être consultée au moyen du composant logiciel enfichable MMC de l’autorité de certification (choisissez la colonne Suppression de la demande).
Exemples
HRESULT hrServer, hr;
// pCertRequest is previously instantiated
// ICertRequest object pointer.
hr = pCertRequest->GetLastStatus((LONG *) &hrServer);
if (FAILED(hr))
{
printf("Failed GetLastStatus [%x]\n", hr);
goto error;
}
else
{
// Use the HRESULT value as needed...
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | certcli.h (inclure Certsrv.h) |
| Bibliothèque | Certidl.lib |
| DLL | Certcli.dll |