ICertServerExit::GetCertificateProperty メソッド (certif.h)

GetCertificateProperty メソッドは、証明書から名前付きプロパティを返します。

構文

HRESULT GetCertificateProperty(
  [in]  const BSTR strPropertyName,
  [in]  LONG       PropertyType,
  [out] VARIANT    *pvarPropertyValue
);

パラメーター

[in] strPropertyName

取得する名前付きプロパティを指定します。 証明書プロパティのストック セット ( 名前プロパティと呼ばれます) は常に有効であり、このメソッドを呼び出すことによって取得できます。 これらのプロパティの詳細については、「 名前のプロパティ」を参照してください。 取得できるその他のプロパティには、証明書のプロパティが含まれます。

次のプロパティは証明書に固有であり、 GetCertificateProperty で読み取ることができます。

証明書の DistinguishedName、RawName、および SerialNumber プロパティは、ポリシー モジュールが要求の処理を完了し、証明書が発行された後にのみ 、GetCertificateProperty からアクセスできます。

証明機関には、次のプロパティが適用 されます。 これらのプロパティのいずれかを読み取る場合、コンテキストは 0 である必要があります。 ICertServerExit オブジェクトが最初に作成されると、コンテキストは 0 に設定されます。 SetContext メソッドを呼び出すことで、0 に設定することもできます。

[in] PropertyType

プロパティの種類を指定します。 型は、次のいずれかになります。

[out] pvarPropertyValue

プロパティ値を格納する VARIANT へのポインター。 戻り値は BSTR としてエンコードされます。 SysStringByteLen 関数を使用して、BSTR の長さを取得します。 バイナリ BLOB は、Distinguished Encoding Rulesエンコードされた X.509 証明書として格納されます。

戻り値

C++

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

VB

解説

このメソッドを使用する前に 、ICertServerExit::SetContext を呼び出す必要があります。

例

BSTR    bstrPropName = NULL;
VARIANT varProp;

VariantInit(&varProp);

// Set the property name to RequestID.
bstrPropName = SysAllocString(L"RequestID");

// Retrieve the certificate property.
// pCertServerExit has been used to call SetContext previously.
hr = pCertServerExit->GetCertificateProperty(bstrPropName,
                                             PROPTYPE_LONG,
                                             &varProp );
if (FAILED(hr))
{
    printf("Failed GetCertificateProperty [%x]\n", hr);
    goto error;
}
else
{
    // Successfully retrieved property; use varProp as needed.
    // ...
}

// Done processing.
if (NULL != bstrPropName)
    SysFreeString(bstrPropName);
VariantClear(&varProp);

要件

関連項目

ICertServerExit

ICertServerExit::SetContext

Name プロパティ