INapSoHProcessor::FindNextAttribute, méthode

Notes

La plateforme de protection d’accès réseau n’est pas disponible à partir de Windows 10

La méthode INapSoHProcessor::FindNextAttribute recherche l’emplacement (index) de l’attribut suivant du type indiqué par SoHAttributeType.

Syntaxe

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

Paramètres

fromLocation [in]

Emplacement de départ (index) dans le paquet Statement of Health (SoH) pour commencer la recherche d’attributs. Cette valeur doit être comprise entre 0 et (numAttrib - 1) où numAttrib est récupéré à l’aide de INapSoHProcessor::GetNumberOfAttributes.

Notes

Le paquet SoH utilise des index d’attribut de base 0.

type [in]

Structure SoHAttributeType qui contient le type d’attribut à localiser.

attributeLocation [out]

Pointeur qui contient l’emplacement (index) dans le paquet SoH du premier attribut de type SoHAttributeType de l’index fromLocation.

Valeur retournée

D’autres codes d’erreur spécifiques à COM peuvent également être retournés.

Code de retour	Description
S_OK	Opération réussie.
E_ACCESSDENIED	Erreur d’autorisations, accès refusé.
E_OUTOFMEMORY	Limite de ressources système, impossible d’effectuer l’opération.
ERROR_FILE_NOT_FOUND	Attribut introuvable.

Notes

La méthode FindNextAttribute recherche des attributs de type SoHAttributeType à partir de l’index spécifié par fromLocation et supérieur jusqu’à ce qu’une correspondance soit trouvée. Si aucune correspondance n’est trouvée, ERROR_FILE_NOT_FOUND est retourné.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	NapProtocol.h
IDL	NapProtocol.idl
DLL	Qutil.dll

Voir aussi

INapSoHProcessor