Fonction FormatPropertyInstance
La fonction FormatPropertyInstance met en forme la propriété instance données à l’aide du formateur générique fourni par Network Monitor.
Syntaxe
DWORD WINAPIV FormatPropertyInstance(
_Inout_ LPPROPERTYINST lpPropertyInst
);
Paramètres
-
lpPropertyInst [in, out]
-
Pointeur vers une structure PROPERTYINST qui contient les données instance.
Lors de l’entrée, le formateur générique prend les données instance de l’un des membres de l’union PROPERTYINST et convertit ces données en une chaîne mise en forme prédéfinie.
Lors de la sortie, le formateur générique définit le membre szPropertyText de la structure PROPERTYINST sur un pointeur vers la chaîne mise en forme.
Valeur retournée
Si la fonction réussit, la valeur de retour est NMERR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur de NMerr.h.
Notes
La DLL de l’analyseur appelle indirectement la fonction FormatPropertyInstance lorsque le formateur générique est requis pour mettre en forme les données à afficher dans le volet d’informations de l’interface utilisateur du Moniteur réseau. Pour appeler FormatPropertyInstance , spécifiez-le dans le membre InstanceData de la structure PROPERTYINFO lorsque vous définissez la propriété .
Notes
L’analyseur ne reconnaît pas la fonction appelée lorsqu’il doit mettre en forme une instance d’une propriété. La fonction peut être FormatPropertyInstance ou une fonction de format personnalisée définie par l’analyseur. L’analyseur appelle la fonction de format spécifiée par le membre InstanceData de la structure PROPERTYINFO pour la propriété .
Pour plus d’informations et un exemple d’implémentation de formatproperties, consultez Implémentation de FormatProperties. Pour plus d’informations sur la façon dont le formateur générique met en forme différents types de données, consultez Sortie du formateur générique.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|