ICertServerPolicy::GetCertificateExtensionFlags メソッド (certif.h)

GetCertificateExtensionFlags メソッドは、GetCertificateExtension の最新の呼び出しによって取得された拡張機能に関連付けられているフラグを取得します。

構文

HRESULT GetCertificateExtensionFlags(
  [out] LONG *pExtFlags
);

パラメーター

[out] pExtFlags

拡張フラグを含む LONG 変数へのポインター。

戻り値

C++

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

VB

注釈

GetCertificateExtensionFlags の前に、SetContext メソッドと GetCertificateExtension メソッドを呼び出す必要があります。 SetContext メソッドは、現在のコンテキストとして使用される要求を指定し、GetCertificateExtension メソッドは要求の拡張機能を取得します。

拡張機能には、ポリシー フラグと配信元フラグを含めることができます。 ポリシー フラグは、証明書拡張機能に関する情報を提供します。 ポリシー フラグは、ポリシー モジュールによって設定できます。 配信元フラグは、証明書拡張機能を設定するモジュールを示します。 配信元フラグは、サーバー エンジンによってのみ設定されます。

拡張機能から 1 つ以上のポリシー フラグを返すことができます。 定義済みのポリシー フラグを次に示します。

次のいずれかの配信元フラグを返すこともできます。

定義済みのマスクは、戻り値に設定されているフラグを簡単に判断するために用意されています。 次のマスクが用意されています。

カスタム データには、高い 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