Função AttachPropertyInstanceEx
A função AttachPropertyInstanceEx mapeia uma propriedade existente para um local específico nos dados reconhecidos e modifica o valor dos dados da propriedade.
Sintaxe
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]
-
Manipule para o quadro que está sendo analisado. Use o identificador passado para a DLL do analisador no parâmetro hFrame da função AttachProperties .
-
hProperty [in]
-
Manipule para uma estrutura PROPERTYINFO que define a propriedade . Ao implementar a função de exportação Registrar, você especifica a estrutura PROPERTYINFO que define a propriedade .
-
Comprimento [in]
-
Comprimento dos dados para essa instância da propriedade.
-
lpData [in]
-
Ponteiro para o local nos dados reconhecidos em que o valor da propriedade está localizado. Use o ponteiro passado para a DLL do analisador no parâmetro lpProtocol da função AttachProperties .
-
LengthEx [in]
-
Comprimento do comprimento de dados estendido em bytes.
-
lpDataEx [in]
-
Ponteiro para os dados estendidos, que normalmente são uma variável de pilha que contém os dados de extensão.
-
HelpID [in]
-
Identificador (de 0 a 2047) usado para definir a Ajuda contextual para uma propriedade.
O número de HelpID é relativo ao arquivo de Ajuda associado ao banco de dados de propriedade de protocolo.
-
IndentLevel [in]
-
Nível de recuo (de 0 a 15) usado para exibir uma propriedade hierarquicamente.
O Monitor de Rede usa níveis de 0 a 9. Nível 15 é um valor especial que permite que o analisador anexe uma propriedade oculta que não está visível.
-
IFlags [in]
-
Um valor de campo BIT que indica a ordem dos BITs em uma propriedade . Os analisadores anteriores que definem fError como 0 ou 1, agora devem definir fError como IFLAG_ERROR. Defina esse parâmetro como um dos valores a seguir.
Valor Significado - IFLAG_ERROR
Os dados no quadro têm um erro. - IFLAG_SWAPPED
No momento da anexação, o byte do WORD é um formato não Intel. - IFLAG_UNICODE
No momento da anexação, STRING é Unicode.
Valor retornado
Se a função for bem-sucedida, o valor retornado será TRUE.
Se a função não for bem-sucedida, o valor retornado será FALSE.
Comentários
A função AttachPropertyInstanceEx é chamada durante a implementação da função de exportação AttachProperties . Quando uma propriedade é anexada aos dados usando AttachPropertyInstanceEx, o Monitor de Rede cria uma estrutura PROPERTYINST que define a instância da propriedade anexada e uma estrutura PROPERTYINSTEX que define os dados estendidos.
Se AttachPropertyInstanceEx for chamado e nenhum dado estendido for fornecido, o parâmetro lpDataEx será NULL ou o parâmetro LengthEx for 0, a chamada AttachPropertyInstanceEx será funcionalmente equivalente a uma chamada AttachPropertyInstance .
Durante a implementação de AttachProperties, chame AttachPropertyInstance para usar os dados como eles existem na captura. Você também pode chamar a função AttachPropertyInstanceEx para modificar os dados da propriedade. No entanto, é recomendável que você use os dados como eles existem na captura.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|