PGET_NEIGHBORS funzione di callback (routprot.h)

Articolo
03/01/2024

La gestione router chiama la funzione GetNeighbors per ottenere il queryr per la rete collegata tramite l'interfaccia specificata.

Il tipo PGET_NEIGHBORS definisce un puntatore a questa funzione di callback. GetNeighbors è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PGET_NEIGHBORS PgetNeighbors;

DWORD PgetNeighbors(
  [in]      DWORD InterfaceIndex,
  [in]      PDWORD NeighborList,
  [in, out] PDWORD NeighborListSize,
  [out]     PBYTE InterfaceFlags
)
{...}

Parametri

[in] InterfaceIndex

Specifica l'indice dell'interfaccia in cui il protocollo di routing deve fornire il queryr.

[in] NeighborList

Puntatore a una matrice di variabili DWORD . Il protocollo di routing deve compilare questa matrice con l'indirizzo del queryr.

Se il computer locale è il queryr per la rete collegata tramite l'interfaccia specificata, il protocollo di routing non deve compilare questa variabile. Al contrario, il protocollo di routing deve impostare il valore a cui punta NeighborListSize su zero. Inoltre, il protocollo di routing deve aggiungere MRINFO_QUERIER_FLAG ai flag restituiti nel parametro InterfaceFlags .

[in, out] NeighborListSize

In input, puntatore a una variabile DWORD .

Nell'output, il protocollo di routing riempie questa variabile con la lunghezza, in byte, dell'indirizzo restituito nel parametro NeighborList .

[out] InterfaceFlags

Riceve uno o più flag seguenti. I flag descrivono la relazione tra il computer locale e altri computer nella rete collegata tramite l'interfaccia specificata.

MRINFO_TUNNEL_FLAGMRINFO_PIM_FLAG MRINFO_DOWN_FLAG MRINFO_DISABLED_FLAGMRINFO_QUERIER_FLAG MRINFO_LEAF_FLAG

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Descrizione
ERROR_CAN_NOT_COMPLETE	Il protocollo di routing non è riuscito a completare la richiesta.
ERROR_INSUFFICIENT_BUFFER	Le dimensioni del buffer a cui punta NeighborList non sono sufficienti per contenere l'indirizzo. La dimensione richiesta viene restituita nella variabile DWORD a cui punta il parametro NeighborListSize .
ERROR_INVALID_PARAMETER	Il parametro InterfaceIndex non è valido( ad esempio, nessuna interfaccia esiste con tale indice).

Commenti

Questa funzione è necessaria solo per i protocolli di routing multicast. I protocolli di routing non multicast devono passare NULL come valore del puntatore per questa funzione in MPR_ROUTING_CHARACTERISTICS

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	routprot.h

Vedi anche

GetMfeStatus

Condividi tramite