ICertAdmin：:P ublishCRL 方法 (certadm.h)

PublishCRL 方法會將要求傳送至證書頒發機構單位 (CA) ，以發佈新的證書吊銷清單 (CRL) 。 這個方法最初是在 ICertAdmin 介面中引進。

語法

HRESULT PublishCRL(
  [in] const BSTR strConfig,
  [in] DATE       Date
);

參數

[in] strConfig

代表 CA 的有效組態字串，格式為 COMPUTERNAME\CANAME，其中 COMPUTERNAME 是憑證服務伺服器的網路名稱，而 CANAME 是證書頒發機構單位的一般名稱，如憑證服務設定期間所輸入。 如需設定字串名稱的相關信息，請參閱 ICertConfig。

重要PublishCRL 不會在設定字串變更時清除內部快取。 當您變更 CA 的組態字串時，必須具現化新的 ICertAdmin 物件，並使用新的組態字串再次呼叫此方法。

 

[in] Date

指定CRL的下一個更新值，以國際標準時間 (Greenwich Mean Time) 。 如果 Date 為非零，CRL 的下一個更新值會是 Date，受限於憑證服務強制執行的四捨五入或上限限制。 如果 Date 為零，則 CRL 的下一個更新值是從預設 CRL 發行週期計算而來。

傳回值

VB

如果方法成功，方法會傳回S_OK。

如果方法失敗，它會傳回指出錯誤的 HRESULT 值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

備註

系統管理工作使用DCOM。 呼叫此介面方法的程式代碼，如舊版 Certadm.h 中所定義，只要客戶端和伺服器都執行相同的 Windows 作業系統，就會在 Windows 伺服器上執行。

範例

下列範例顯示發佈CRL。

    DATE ExpDate;  // CRL expiration date
    SYSTEMTIME st;
    BSTR bstrCA = NULL;

    //  Set the CRL Expiration Date to Noon on Jan. 1, 2005 GMT.
    //  Zero out values first 
	//  (avoids setting minutes, seconds, and so on).
    memset(&st, 0, sizeof(SYSTEMTIME));
    st.wYear = 2005;
    st.wMonth = 1;     // Jan
    st.wDay = 1;       // 1st day of month
    st.wHour = 12;     // Noon

    //  Place the date in required format.
    if (!SystemTimeToVariantTime(&st, &ExpDate))
    {
        printf("Unable to convert time\n");
        goto error;
    }

    bstrCA = SysAllocString(L"<COMPUTERNAMEHERE>\\<CANAMEHERE>");
    if (NULL == bstrCA)
    {
        printf("Memory allocation failed\n");
        goto error;
    }

    //  Publish the CRL.
    //  pCertAdmin is a previously instantiated ICertAdmin object.
    hr = pCertAdmin->PublishCRL(bstrCA, ExpDate);
    if (FAILED(hr))
    {
        printf("Failed PublishCRL [%x]\n", hr);
        goto error;
    }
    else
        printf("PublishCRL succeeded\n");

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	certadm.h (包含 Certsrv.h)
程式庫	Certidl.lib
Dll	Certadm.dll

另請參閱

CCertAdmin

ICertAdmin

ICertAdmin2

ICertConfig