Función AttachPropertyInstanceEx
La función AttachPropertyInstanceEx asigna una propiedad existente a una ubicación específica de los datos reconocidos y modifica el valor de los datos de propiedad.
Sintaxis
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
);
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 .
-
LengthEx [in]
-
Longitud de la longitud extendida de los datos en bytes.
-
lpDataEx [in]
-
Puntero a los datos extendidos, que suele ser una variable de pila que contiene los datos extendidos.
-
HelpID [in]
-
Identificador (de 0 a 2047) que se usa para establecer ayuda contextual para una propiedad.
El número helpID 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 del 0 al 9. El nivel 15 es un valor especial que permite al analizador adjuntar 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.
Valor 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.
Observaciones
Se llama a la función AttachPropertyInstanceEx durante la implementación de la función de exportación AttachProperties . Cuando una propiedad se adjunta a los datos mediante AttachPropertyInstanceEx, Network Monitor crea una estructura PROPERTYINST que define la instancia de la propiedad adjunta y una estructura PROPERTYINSTEX que define los datos extendidos.
Si se llama a AttachPropertyInstanceEx y no se proporciona ningún dato extendido, el parámetro lpDataEx es NULL o el parámetro LengthEx es 0, la llamada a AttachPropertyInstanceEx es funcionalmente equivalente a una llamada AttachPropertyInstance .
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.
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 |
|