AttachPropertyInstanceEx fonction)

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 [ dans]

Handle vers le frame en cours d’analyse. Utilisez le descripteur passé à la DLL de l’analyseur dans le paramètre hFrame de la fonction AttachProperties .

hProperty [ dans]

Handle vers une structure PROPERTYINFO qui définit la propriété. Lorsque vous implémentez la fonction d’exportation de Registre , vous spécifiez la structure PROPERTYINFO qui définit la propriété.

Longueur [ dans]

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

lpData [ dans]

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 [ dans]

Longueur de la longueur des données étendues, en octets.

lpDataEx [ dans]

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

HelpID [ dans]

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 deprotocole.

IndentLevel [ dans]

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

Moniteur réseau 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 [ dans]

Valeur de champ de bits qui indique l’ordre des BITs dans une propriété. Les analyseurs précédents qui définissent le paramétrage de la valeur 0 ou 1 devraient maintenant définir l' erreur de l’IFLAG _ . Définissez ce paramètre sur l’une des valeurs suivantes.

Valeur Signification
_erreur IFLAG
Les données du frame comportent une erreur.
IFLAG _ échangé
Au moment de l’attachement, le mot Byte n’est pas au format Intel.
IFLAG _ Unicode
Au moment de l’attachement, la chaîne est Unicode.

Valeur de retour

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

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

Remarques

La fonction AttachPropertyInstanceEx est appelée pendant l’implémentation de la fonction d’exportation AttachProperties . Quand une propriété est attachée aux données à l’aide de AttachPropertyInstanceEx, Moniteur réseau crée une structure PROPERTYINST qui définit l’instance de la propriété jointe et une structure PROPERTYINSTEX qui définit les données étendues.

Si AttachPropertyInstanceEx est appelée 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.

Configuration requise

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
Netmon. h
Bibliothèque
Nmapi. lib
DLL
Nmapi.dll