ICertServerExit::EnumerateAttributes メソッド (certif.h)

EnumerateAttributes メソッドは、現在のコンテキスト内の次の要求属性の名前を返し、内部ポインターを次の属性にインクリメントします。

EnumerateAttributes を呼び出す前に、アプリケーションは ICertServerExit::EnumerateAttributesSetup を呼び出します。列挙が完了すると、アプリケーションは ICertServerExit::EnumerateAttributesClose を呼び出します。

構文

HRESULT EnumerateAttributes(
  [out] BSTR *pstrAttributeName
);

[out] pstrAttributeName

列挙された属性名へのポインター。

メソッドが成功した場合、メソッドは S_OKを返し、*pstrAttributeName は列挙属性の名前を含む BSTR に設定されます。最後の属性が既に列挙されている場合は、S_FALSE の値が返されます。

このメソッドを使用するには、 BSTR 型の変数を作成し、変数を NULL に設定し、この変数のアドレス を pstrAttributeName として渡します。

BSTR の使用が完了したら、SysFreeString 関数を呼び出して解放します。

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

列挙された属性の名前を含む文字列を返します。最後の属性が既に列挙されている場合は空の文字列を返します。