Funzione CreateProtocol

La funzione CreateProtocol notifica a Monitoraggio di rete che esiste un parser di protocollo specifico.

Sintassi

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

Parametri

ProtocolName [in]

Nome del protocollo che verrà rilevato dal parser.

lpEntryPoints [in]

Struttura ENTRYPOINTS che contiene i punti di ingresso della DLL del parser rimanenti. Per un elenco delle funzioni di esportazione a cui fa riferimento ogni punto di ingresso, vedere La sezione Osservazioni. I punti di ingresso devono essere specificati nell'ordine specificato dalla struttura ENTRYPOINTS .

cbEntryPoints [in]

Dimensioni della struttura ENTRYPOINTS . Monitoraggio di rete fornisce una macro ENTRYPOINTS_SIZE che è possibile usare per specificare le dimensioni della struttura.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il protocollo.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

La DLL del parser chiama CreateProtocol durante l'implementazione di DllMain. La funzione CreateProtocol viene chiamata quando il sistema operativo carica la DLL del parser per la prima volta.

I punti di ingresso a cui si fa riferimento nel parametro lpEntryPoints includono puntatori alle funzioni di esportazione seguenti che devono essere fornite nell'ordine presentato qui.

• Registra
• Annullamento registrazione
• RecognizeFrame
• AttachProperties
• FormatProperties

Per informazioni su	Vedere
Quali parser sono e come funzionano con Monitoraggio di rete.	Parser
Come implementare DllMain include un esempio di chiamata a CreateProtocol all'interno di DllMain.	Implementazione di DllMain

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Netmon.h
Libreria	Nmapi.lib
DLL	Nmapi.dll

Vedi anche

DllMain