Função AttachPropertyInstance
A função AttachPropertyInstance mapeia uma propriedade existente para um local específico nos dados reconhecidos.
Sintaxe
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]
-
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 .
-
HelpID [in]
-
Identificador (de 0 a 2047) usado para definir a Ajuda contextual para a propriedade.
O número do identificador é 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 14 para recuar propriedades. Nível 15 é um valor especial que permite que um 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 AttachPropertyInstance é chamada durante a implementação da função de exportação AttachProperties . Quando uma propriedade é anexada aos dados, o Monitor de Rede cria uma estrutura PROPERTYINST que define a instância da propriedade anexada.
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.
| Para obter informações sobre | Consulte |
|---|---|
| O que são analisadores e como eles funcionam com o Monitor de Rede. | Analisadores |
| Como chamar AttachPropertyInstance. | Implementando AttachProperties |
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 |
|