Condividi tramite

PADD_INTERFACE funzione di callback (routprot.h)

  • Articolo

La funzione AddInterface aggiunge un'interfaccia da gestire dal protocollo di routing. Il protocollo deve considerare l'interfaccia in uno stato disabilitato. La gestione router abilita l'interfaccia chiamando InterfaceStatus con il flag di RIS_INTERFACE_ENABLED.

Quando un utente chiama MprAdminInterfaceTransportAdd, gestione interfaccia dinamica per il trasporto chiama gestione router (per il trasporto) che chiama questa funzione per ogni protocollo di routing associato a tale trasporto.

Sintassi

PADD_INTERFACE PaddInterface;

DWORD PaddInterface(
  [in] LPWSTR InterfaceName,
  [in] ULONG InterfaceIndex,
  [in] NET_INTERFACE_TYPE InterfaceType,
  [in] DWORD MediaType,
  [in] WORD AccessType,
  [in] WORD ConnectionType,
  [in] PVOID InterfaceInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

Parametri

[in] InterfaceName

Puntatore a una stringa Unicode. La stringa contiene un nome che identifica in modo univoco l'interfaccia nel set di interfacce configurate nel router.

[in] InterfaceIndex

Specifica l'interfaccia nel set di interfacce configurate nel router.

[in] InterfaceType

Specifica il tipo dell'interfaccia.

Valore Significato
PERMANENTE
 Connettività permanente (ad esempio, LAN, Inoltro frame).
DEMAND_DIAL
 Connettività di chiamata richiesta (analogico, ISDN, PPTP, commutato FR).
LOCAL_WORKSTATION_DIAL
 Solo connettività della workstation locale.
REMOTE_WORKSTATION_DIAL
 Solo connettività della workstation remota.

[in] MediaType

Riservato per usi futuri.

[in] AccessType

Riservato per usi futuri.

[in] ConnectionType

Riservato per usi futuri.

[in] InterfaceInfo

Puntatore a un buffer che specifica le informazioni di configurazione definite dal protocollo associate all'interfaccia. Queste informazioni sono private del protocollo di routing.

[in] StructureVersion

Specifica la versione delle strutture di informazioni a cui punta il parametro InterfaceInfo . In alcuni casi, questa è uguale alla versione del protocollo di routing.

[in] StructureSize

Specifica le dimensioni di ognuna delle strutture di informazioni a cui punta il parametro InterfaceInfo . Poiché alcune strutture di informazioni contengono membri di lunghezza variabile, il protocollo di routing non è necessariamente in grado di determinare le dimensioni delle informazioni dalla versione.

[in] StructureCount

Specifica un conteggio del numero di strutture di informazioni a cui fa riferimento il parametro InterfaceInfo . Questo parametro è sempre uno.

Valore restituito

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

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

Valore Descrizione
ERROR_CAN_NOT_COMPLETE
 Tentativo di aggiungere l'interfaccia non riuscita.
ERROR_INVALID_PARAMETER
 Il parametro InterfaceIndex non è valido(ad esempio, un'interfaccia con tale indice esiste già) o uno dei parametri puntati da InterfaceInfo non è valido.
 
 

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

DeleteInterface

Funzioni di interfaccia del protocollo di routing

Informazioni di riferimento sulle interfacce del protocollo di routing