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

GetName メソッドは、属性列挙シーケンス内の現在の属性の名前を取得します。

構文

HRESULT GetName(
  [out] BSTR *pstrOut
);

パラメーター

[out] pstrOut

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

戻り値

C++

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

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

VB

注釈

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

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

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

例

BSTR    bstrAttribName = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetName(&bstrAttribName);
if (S_OK != hr)
    printf("Failed call to GetName - %x\n", hr);
else
    printf("Attribute name is %ws\n", bstrAttribName );

// free memory when done
if (NULL != bstrAttribName)
    SysFreeString(bstrAttribName);

要件

こちらもご覧ください

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWATTRIBUTE::GetValue

IEnumCERTVIEWATTRIBUTE::Next

IEnumCERTVIEWATTRIBUTE::Reset

IEnumCERTVIEWATTRIBUTE::Skip