Función AttachPropertyInstance
La función AttachPropertyInstance asigna una propiedad existente a una ubicación específica de los datos reconocidos.
Sintaxis
BOOL WINAPI AttachPropertyInstance(
_In_ HFRAME hFrame,
_In_ HPROPERTY hProperty,
_In_ DWORD Length,
_In_ ULPVOID lpData,
_In_ DWORD HelpID,
_In_ DWORD IndentLevel,
_In_ DWORD IFlags
);
Parámetros
-
hFrame [in]
-
Controle el marco que se está a analizar. Use el identificador pasado al archivo DLL del analizador en el parámetro hFrame de la función AttachProperties .
-
hProperty [in]
-
Controle a una estructura PROPERTYINFO que defina la propiedad . Al implementar la función Register export , especifique la estructura PROPERTYINFO que define la propiedad .
-
Longitud [in]
-
Longitud de los datos de esta instancia de la propiedad.
-
lpData [in]
-
Puntero a la ubicación de los datos reconocidos donde se encuentra el valor de la propiedad. Use el puntero pasado al archivo DLL del analizador en el parámetro lpProtocol de la función AttachProperties .
-
HelpID [in]
-
Identificador (de 0 a 2047) que se usa para establecer ayuda contextual para la propiedad .
El número de identificador es relativo al archivo de Ayuda asociado a la base de datos de propiedades de protocolo.
-
IndentLevel [in]
-
Nivel de sangría (de 0 a 15) que se usa para mostrar una propiedad jerárquicamente.
Network Monitor usa los niveles 0 a 14 para las propiedades de sangría. El nivel 15 es un valor especial que permite que un analizador adjunte una propiedad oculta que no esté visible.
-
IFlags [in]
-
Valor de campo BIT que indica el orden de las BIT dentro de una propiedad . Los analizadores anteriores que establecen fError en 0 o 1, ahora deben establecer fError en IFLAG_ERROR. Establezca este parámetro en uno de los valores siguientes.
Value Significado - IFLAG_ERROR
Los datos del marco tienen un error. - IFLAG_SWAPPED
En el momento de adjuntar, el byte de WORD es un formato que no es Intel. - IFLAG_UNICODE
En el momento de la asociación, STRING es Unicode.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es TRUE.
Si la función no se realiza correctamente, el valor devuelto es FALSE.
Comentarios
Se llama a la función AttachPropertyInstance durante la implementación de la función de exportación AttachProperties . Cuando se adjunta una propiedad a los datos, Network Monitor crea una estructura PROPERTYINST que define la instancia de la propiedad adjunta.
Durante la implementación de AttachProperties, llame a AttachPropertyInstance para usar los datos tal como existen en la captura. También puede llamar a la función AttachPropertyInstanceEx para modificar los datos de propiedad. Sin embargo, se recomienda usar los datos tal y como existen en la captura.
| Para obtener información sobre | Vea |
|---|---|
| Qué son los analizadores y cómo funcionan con Network Monitor. | Analizadores |
| Cómo llamar a AttachPropertyInstance. | Implementación de AttachProperties |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|