Função CreateProtocol

A função CreateProtocol notifica o Monitor de Rede de que existe um analisador de protocolo específico.

Sintaxe

HPROTOCOL WINAPI CreateProtocol(
  _In_ LPSTR         ProtocolName,
  _In_ LPENTRYPOINTS lpEntryPoints,
  _In_ DWORD         cbEntryPoints
);

Parâmetros

ProtocolName [in]

Nome do protocolo que o analisador detectará.

lpEntryPoints [in]

Uma estrutura ENTRYPOINTS que contém os pontos de entrada de DLL do analisador restantes. Consulte Comentários para obter uma lista das funções de exportação que cada ponto de entrada faz referência. Os pontos de entrada devem ser fornecidos na ordem especificada pela estrutura ENTRYPOINTS .

cbEntryPoints [in]

O tamanho da estrutura ENTRYPOINTS . O Monitor de Rede fornece uma macro ENTRYPOINTS_SIZE que você pode usar para especificar o tamanho da estrutura.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um identificador para o protocolo.

Se a função não for bem-sucedida, o valor retornado será NULL.

Comentários

A DLL do analisador chama CreateProtocol durante sua implementação de DllMain. A função CreateProtocol é chamada quando o sistema operacional carrega a DLL do analisador pela primeira vez.

Os pontos de entrada referenciados no parâmetro lpEntryPoints incluem ponteiros para as seguintes funções de exportação que devem ser fornecidas na ordem apresentada aqui.

• Registrar
• Cancelar registro
• RecognizeFrame
• AttachProperties
• FormatProperties

Para obter informações sobre	Consulte
O que são analisadores e como eles funcionam com o Monitor de Rede.	Analisadores
Como implementar dllMain inclui um exemplo de chamada de CreateProtocol dentro de DllMain.	Implementando DllMain

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	Netmon.h
Biblioteca	Nmapi.lib
DLL	Nmapi.dll

Confira também

DllMain