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

[アーティクル]
08/22/2023

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

構文

HRESULT GetName(
  [out] BSTR *pstrOut
);

パラメーター

[out] pstrOut

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

戻り値

C++

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

このメソッドを使用するには、 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);

要件

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