ICertServerPolicy：：GetCertificateExtensionFlags 方法 (certif.h)

GetCertificateExtensionFlags 方法會擷取與最近呼叫 GetCertificateExtension 所取得之擴充功能相關聯的旗標。

語法

HRESULT GetCertificateExtensionFlags(
  [out] LONG *pExtFlags
);

參數

[out] pExtFlags

LONG 變數的指標，其中包含延伸模組旗標。

傳回值

C++

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

VB

備註

必須先呼叫 SetContext 和 GetCertificateExtension 方法， 才能呼叫 GetCertificateExtensionFlags。 SetContext 方法會指定使用哪個要求做為目前內容，而 GetCertificateExtension 方法會擷取要求的延伸模組。

延伸模組可以包含原則和原始旗標。 原則旗標提供憑證延伸模組的相關信息。 原則模組可以設定原則旗標。 原始旗標表示設定憑證延伸模組的模組。 原始旗標只能由伺服器引擎設定。

您可以從延伸模組傳回一或多個原則旗標。 以下是預先定義的原則旗標。

您也可以傳回下列其中一個原始旗標。

提供預先定義的遮罩，以方便用來判斷傳回值中設定的旗標。 提供下列遮罩。

使用自定義數據的高 8 位EXTENSION_POLICY_MASK是安全的。 這些位會持續儲存在資料庫中，但不會寫入憑證延伸模組。

範例

HRESULT  hr;
LONG     ExtFlags;
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->GetCertificateExtensionFlags( &ExtFlags);

// More than one policy flag might be set.
LONG ExtPolicyFlags = ExtFlags & EXTENSION_POLICY_MASK;

if (ExtPolicyFlags & EXTENSION_CRITICAL_FLAG)
{
    // Do something.
}

if (ExtPolicyFlags & EXTENSION_DISABLE_FLAG)
{
    // Do something.
}

// only one origin flag can be set
switch (ExtFlags & EXTENSION_ORIGIN_MASK)
{
    case EXTENSION_ORIGIN_REQUEST:
        // Extension was set in certificate request.
        break;
    case EXTENSION_ORIGIN_POLICY:
        // Extension was set by policy module.
        break;
    case EXTENSION_ORIGIN_ADMIN:
        // Extension was set by administrator.
        break;
    case EXTENSION_ORIGIN_SERVER:
        // Extension was set by server engine.
        break;
    default:
        break;
}

規格需求

另請參閱

ICertAdmin：：SetCertificateExtension

ICertServerPolicy

ICertServerPolicy：：GetCertificateExtension

ICertServerPolicy：：SetContext

IEnumCERTVIEWEXTENSION：：GetFlags