IEnumCERTVIEWCOLUMN::GetName メソッド (certview.h)

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

GetName メソッドは、列列挙シーケンス内の現在の列の未割り当て名を取得します。

構文

HRESULT GetName(
  [out] BSTR *pstrOut
);

パラメーター

[out] pstrOut

列の名前を含む BSTR 型の変数へのポインター。

戻り値

C++

メソッドが成功した場合、メソッドは S_OKを返し、 pstrOut パラメーターには列の名前が含まれます。

このメソッドを使用するには、 BSTR 型の変数を作成し、変数を NULL に設定し、この変数のアドレス を pstrOut として渡します。 BSTR の使用が完了したら、SysFreeString 関数を呼び出して解放します。

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

VB

戻り値は、列の名前を含む 文字列 です。

注釈

このメソッドは、列列挙シーケンスによって現在参照されている列の非ローカライズされた名前を取得するために使用されます。

列列挙シーケンスが有効な列を参照していない場合、 GetName は失敗します。列挙型内を移動するには、次のいずれかのメソッドを使用します。

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

例

BSTR       bstrColName = NULL;
HRESULT    hr;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
hr = pEnumCol->GetName(&bstrColName);
if (S_OK == hr)
    printf("Column name is %ws\n", bstrColName);

// done processing, clear resources
if (NULL != bstrColName)
    SysFreeString(bstrColName);

要件

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