Fonction AttachPropertyInstance

La fonction AttachPropertyInstance mappe une propriété existante à un emplacement spécifique dans les données reconnues.

Syntaxe

BOOL WINAPI AttachPropertyInstance(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     HelpID,
  _In_ DWORD     IndentLevel,
  _In_ DWORD     IFlags
);

Paramètres

hFrame [in]

Gérez le cadre en cours d’analyse. Utilisez le handle passé à la DLL de l’analyseur dans le paramètre hFrame de la fonction AttachProperties .

hProperty [in]

Gérez vers une structure PROPERTYINFO qui définit la propriété. Lorsque vous implémentez la fonction d’exportation Register , vous spécifiez la structure PROPERTYINFO qui définit la propriété.

Longueur [in]

Longueur des données de cette instance de la propriété.

lpData [in]

Pointeur vers l’emplacement dans les données reconnues où se trouve la valeur de la propriété. Utilisez le pointeur passé à la DLL de l’analyseur dans le paramètre lpProtocol de la fonction AttachProperties .

HelpID [in]

Identificateur (de 0 à 2047) utilisé pour définir l’aide contextuelle de la propriété.

Le numéro d’identificateur est relatif au fichier d’aide associé à la base de données de propriétés de protocole.

IndentLevel [in]

Niveau de mise en retrait (de 0 à 15) utilisé pour afficher une propriété hiérarchiquement.

Network Monitor utilise les niveaux 0 à 14 pour mettre en retrait les propriétés. Le niveau 15 est une valeur spéciale qui permet à un analyseur d’attacher une propriété masquée qui n’est pas visible.

IFlags [in]

Valeur de champ BIT qui indique l’ordre des BIT au sein d’une propriété. Les analyseurs précédents qui définissent fError sur 0 ou 1 doivent maintenant définir fError sur IFLAG_ERROR. Définissez ce paramètre sur l’une des valeurs suivantes.

Valeur	Signification
IFLAG_ERROR	Les données dans le cadre ont une erreur.
IFLAG_SWAPPED	Au moment de l’attachement, l’octet WORD est un format non Intel.
IFLAG_UNICODE	Au moment de l’attachement, STRING est Unicode.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE.

Notes

La fonction AttachPropertyInstance est appelée pendant l’implémentation de la fonction d’exportation AttachProperties . Lorsqu’une propriété est attachée aux données, Network Monitor crée une structure PROPERTYINST qui définit la instance de la propriété jointe.

Pendant l’implémentation de AttachProperties, appelez AttachPropertyInstance pour utiliser les données telles qu’elles existent dans la capture. Vous pouvez également appeler la fonction AttachPropertyInstanceEx pour modifier les données de propriété. Toutefois, il est recommandé d’utiliser les données telles qu’elles existent dans la capture.

Spécifications

Voir aussi

AttachProperties

AttachPropertyInstanceEx

PROPERTYINST