ICertRequest::GetLastStatus 方法 (certcli.h)
GetLastStatus 方法获取此请求的最后一个返回代码。 这会返回错误代码信息,而不是请求的处置。
语法
HRESULT GetLastStatus(
[out] LONG *pStatus
);
参数
[out] pStatus
指向请求状态代码的指针。
返回值
C++
如果方法成功,该方法将返回S_OK。成功完成此函数后,*pStatus 将设置为 对 ICertRequest3::Submit、 ICertRequest3::RetrievePending 或 ICertRequest3::GetCACertificate 的最新调用的结果代码。
如果方法失败,它将返回一个 指示错误的 HRESULT 值。 有关常见错误代码的列表,请参阅 通用 HRESULT 值。
VB
返回值是最近调用 CCertRequest3.Submit、 CCertRequest3.RetrievePending 或 CCertRequest3.GetCACertificate 的结果代码。注解
GetLastStatus 检索的值取决于对 ICertRequest3::Submit、ICertRequest3::RetrievePending 或 ICertRequest3::GetCACertificate 的最新调用。 如果对其中一种方法的调用在服务器上失败,请调用 GetLastStatus 来检索错误号。 某些服务器故障 (例如拒绝的请求) 从方法调用返回S_OK和处置CR_DISP_ISSUED,并且可以使用 GetLastStatus 检索特定的失败原因。 如果调用这些方法之一成功,则对 GetLastStatus 的后续调用将返回S_OK () 零。
此外,请求处置存储在证书服务数据库中,可以通过证书颁发机构 MMC 管理单元查看 (选择“请求处置”列) 。
示例
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...
}
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | certcli.h (包括 Certsrv.h) |
Library | Certidl.lib |
DLL | Certcli.dll |