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 |
|
| Bibliothèque |
|
| DLL |
|