funzione di callback PREGISTER_PROTOCOL (routprot.h)
La funzione RegisterProtocol registra il protocollo di routing con la gestione router. Informa inoltre il gestore router della funzionalità supportata dal protocollo di routing.
Sintassi
PREGISTER_PROTOCOL PregisterProtocol;
DWORD PregisterProtocol(
[in, out] PMPR_ROUTING_CHARACTERISTICS pRoutingChar,
[in, out] PMPR_SERVICE_CHARACTERISTICS pServiceChar
)
{...}
Parametri
[in, out] pRoutingChar
In input, puntatore a una struttura MPR_ROUTING_CHARACTERISTICS .
Nell'output, riceve i puntatori alle funzioni implementate per il protocollo di routing.
Per altre informazioni su come usarla con la funzione RegisterProtocol, vedere la pagina di riferimento per la struttura MPR_ROUTING_CHARACTERISTICS.
[in, out] pServiceChar
In input, puntatore a una struttura MPR_SERVICE_CHARACTERISTICS .
Nell'output, riceve i puntatori alle funzioni implementate per il protocollo di routing.
Per altre informazioni su come usarla con la funzione RegisterProtocol, vedere la pagina di riferimento per la struttura MPR_SERVICE_CHARACTERISTICS.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.
Se la funzione ha esito negativo, il valore restituito viene ERROR_NOT_SUPPORTED.
Commenti
Tutte le DLL del protocollo di routing devono compilare i valori per la struttura MPR_ROUTING_CHARACTERISTICS .
Le DLL del protocollo di routing che forniscono servizi devono compilare i valori per la struttura MPR_SERVICE_CHARACTERISTICS . Se una DLL del protocollo di routing non fornisce servizi, deve compilare zero per il membro fSupportedFunctionality di questa struttura, ma non deve compilare i valori per gli altri membri.
I protocolli di routing vengono implementati nelle DLL in modalità utente. Una singola DLL può implementare più protocolli di routing. Pertanto, gestione router può chiamare RegisterProtocol più volte, una volta per ogni protocollo di routing implementato nella DLL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | routprot.h |