ICertConfig::GetField メソッド (certcli.h)

GetField メソッドは、構成データベースの現在のレコードから特定のフィールドを取得します。 このメソッドは、最初に ICertConfig インターフェイスで定義されました。

構文

HRESULT GetField(
  [in]          const BSTR strFieldName,
  [out, retval] BSTR       *pstrOut
);

パラメーター

[in] strFieldName

返すフィールドの名前を指定します。 このパラメーターには、フィールド名に対して次のいずれかの有効な文字列を指定できます (一部の証明機関は、各フィールドのデータを提供しない場合があることに注意してください)。

[out, retval] pstrOut

フィールドからデータを受信する BSTR へのポインター。 BSTR の使用が完了したら、SysFreeString 関数を呼び出して pbstrOut を解放します。

戻り値

C++

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

VB

注釈

このメソッドは、指定したフィールドのフィールド データを返します。

strFieldName パラメーターに "Flags" を指定すると、flags フィールドに対して取得されたデータは、C ライブラリ関数_wtoiを使用して整数に変換できる文字列になります。 結果の整数は、フラグがCAIF_DSENTRYおよびCAIF_SHAREDFOLDERENTRYが設定されているかどうかを判断するために調べることができるビットフィールドを表します。 CAIF_DSENTRY (0x00000001) が設定されている場合、CA の情報は Directory Services に含まれていました。 CAIF_SHAREDFOLDERENTRY (0x00000002) が設定されている場合、CA の情報は共有フォルダーに含まれていました。 これらのフラグの一方または両方を設定できます。

例

    BSTR  bstrFieldName = NULL;
    BSTR  bstrFieldValue = NULL;
    HRESULT    hr;

    // Specify the field to retrieve, for example, "CommonName".
    bstrFieldName = SysAllocString(L"<FIELDNAMEHERE>");
    if (NULL == bstrFieldName)
    {
        printf("Memory allocation failed for bstrFieldName.\n");
        goto error;
    }

    // pConfig is a previously instantiated ICertConfig object.
    hr = pConfig->GetField(bstrFieldName, &bstrFieldValue);
    if (FAILED(hr))
    {
        printf("Failed GetField - [%x]\n", hr);
        goto error;
    }
    else
        printf("GetField value for %ws is: %ws\n", 
            bstrFieldName, bstrFieldValue );

error:

    if (bstrFieldName)
        SysFreeString(bstrFieldName);

    if (bstrFieldValue)
        SysFreeString(bstrFieldValue);

要件

こちらもご覧ください

CCertConfig

ICertConfig