ICertRequest：：GetLastStatus 方法 (certcli.h)

發行項
02/23/2024

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)
程式庫	Certidl.lib
Dll	Certcli.dll