Fonction AttachPropertyInstanceEx

La fonction AttachPropertyInstanceEx mappe une propriété existante à un emplacement spécifique dans les données reconnues et modifie la valeur des données de propriété.

Syntaxe

BOOL WINAPI AttachPropertyInstanceEx(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     LengthEx,
  _In_ ULPVOID   lpDataEx,
  _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 .

LengthEx [in]

Longueur de la longueur étendue des données en octets.

lpDataEx [in]

Pointeur vers les données étendues, qui est généralement une variable de pile qui contient les données étendues.

HelpID [in]

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

Le numéro HelpID 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 à 9. Le niveau 15 est une valeur spéciale qui permet à l’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 AttachPropertyInstanceEx est appelée pendant l’implémentation de la fonction d’exportation AttachProperties . Lorsqu’une propriété est attachée aux données à l’aide de AttachPropertyInstanceEx, Network Monitor crée une structure PROPERTYINST qui définit la instance de la propriété jointe et une structure PROPERTYINSTEX qui définit les données étendues.

Si AttachPropertyInstanceEx est appelé et qu’aucune donnée étendue n’est fournie, le paramètre lpDataEx est NULL ou le paramètre LengthEx est 0, l’appel AttachPropertyInstanceEx est fonctionnellement équivalent à un appel AttachPropertyInstance .

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