ICertRequest ::GetLastStatus, méthode (certcli.h)

Article
02/23/2024

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