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.
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 |
|
Libreria |
|
DLL |
|