IEnumCERTVIEWROW::EnumCertViewColumn メソッド (certview.h)

[アーティクル]
02/28/2024

EnumCertViewColumn メソッドは、行列挙シーケンスの現在の行の列列挙シーケンスのインスタンスを取得します。

構文

HRESULT EnumCertViewColumn(
  [out] IEnumCERTVIEWCOLUMN **ppenum
);

パラメーター

[out] ppenum

IEnumCERTVIEWCOLUMN 型のポインターへのポインター。

戻り値

C++

メソッドが成功した場合、メソッドは S_OKを返します。

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

VB

戻り値は、列列挙シーケンスオブジェクトです。

注釈

この呼び出しによって取得された列列挙シーケンスを使用して、現在の行の証明書に関連付けられている列を列挙できます。この列挙には、 IEnumCERTVIEWCOLUMN インターフェイスのメソッドを使用してアクセスできます。

別の行を参照するには、次のいずれかのメソッドを呼び出して、行列挙シーケンス内を移動します。

IEnumCERTVIEWROW::Reset: 列挙シーケンスの先頭に移動します。
IEnumCERTVIEWROW::Next: 列挙シーケンス内の次の行に移動します。
IEnumCERTVIEWROW::Skip: 指定された行数をスキップします。

例

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT               hr;
LONG                  Index;
IEnumCERTVIEWCOLUMN * pEnumCol = NULL;
// obtain enumerator for columns
hr = pEnumRow->EnumCertViewColumn(&pEnumCol);
if ( FAILED( hr ))
{
    printf("Failed EnumCertViewColumn - %x\n", hr );
    goto error;
}
// enumerate each column
while (S_OK == pEnumCol->Next(&Index))
{
    // Use this column as needed.
}
error:

// Free resources.
if ( NULL != pEnumCol )
    pEnumCol->Release();

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	certview.h (Certsrv.h を含む)
Library	Certidl.lib
[DLL]	Certadm.dll