INapSoHProcessor::FindNextAttribute メソッド

注意

ネットワーク アクセス保護プラットフォームは、Windows 10 以降は使用できません

INapSoHProcessor::FindNextAttribute メソッドは、SoHAttributeType で示される型の次の属性の場所 (インデックス) を検索します。

構文

HRESULT FindNextAttribute(
  [in]  UINT16           fromLocation,
  [in]  SoHAttributeType type,
  [out] UINT16           *attributeLocation
);

パラメーター

fromLocation [in]

属性検索を開始する正常性ステートメント (SoH) パケット内の開始位置 (インデックス)。 この値は、INapSoHProcessor::GetNumberOfAttributes を使用して numAttrib が取得される 0 ~ (numAttrib - 1) の範囲である必要があります。

注意

SoH パケットでは、0 ベースの属性インデックスが使用されます。

type [in]

検索する属性型を含む SoHAttributeType 構造体。

attributeLocation [out]

インデックス fromLocation の SoHAttributeType 型の最初の属性の SoH パケット内の場所 (インデックス) を格納するポインター。

戻り値

他の COM 固有のエラー コードも返される場合があります。

リターン コード	説明
S_OK	操作に成功しました。
E_ACCESSDENIED	アクセス許可エラー、アクセスが拒否されました。
E_OUTOFMEMORY	システム リソースの制限。操作を実行できませんでした。
ERROR_FILE_NOT_FOUND	属性が見つかりません。

解説

FindNextAttribute メソッドは、一致が見つかるまで、fromLocation 以降で指定されたインデックスから SoHAttributeType 型の属性を検索します。 一致するものが見つからない場合は、 ERROR_FILE_NOT_FOUND が返されます。

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー	NapProtocol.h
IDL	NapProtocol.idl
[DLL]	Qutil.dll

関連項目

INapSoHProcessor