Condividi tramite


Funzione MprAdminInterfaceTransportAdd (mprapi.h)

La funzione MprAdminInterfaceTransportAdd aggiunge un trasporto ,ad esempio IP o IPX, a un'interfaccia specificata.

Sintassi

DWORD MprAdminInterfaceTransportAdd(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwTransportId,
  [in] LPBYTE            pInterfaceInfo,
  [in] DWORD             dwInterfaceInfoSize
);

Parametri

[in] hMprServer

Gestire il router in cui vengono aggiunte informazioni. Ottenere questo handle chiamando MprAdminServerConnect.

[in] hInterface

Gestire l'interfaccia in cui viene aggiunto il trasporto. Questo handle viene ottenuto da una chiamata precedente a MprAdminInterfaceCreate.

[in] dwTransportId

Valore DWORD che descrive il tipo di trasporto da aggiungere all'interfaccia. I valori accettabili per dwTransportId sono elencati nella tabella seguente.

Valore Trasporto (famiglia di protocolli)
PID_ATALK Appletalk
PID_IP Internet Protocol versione 4
PID_IPX Scambio pacchetti Internet
PID_NBF Protocollo Frame NetBIOS
PID_IPV6 Windows Server 2008 o versione successiva: Protocollo Internet versione 6

[in] pInterfaceInfo

Puntatore a un'intestazione di informazioni che specifica le informazioni sull'interfaccia per questo trasporto. Usare le funzioni di intestazione informazioni per modificare le intestazioni di informazioni.

[in] dwInterfaceInfoSize

Specifica le dimensioni, in byte, delle informazioni a cui fa riferimento pInterfaceInfo.

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 Significato
ERROR_ACCESS_DENIED
L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_INVALID_HANDLE
Il valore hInterface non è valido.
ERROR_INVALID_PARAMETER
Il parametro pInterfaceInfo è NULL.
ERROR_UNKNOWN_PROTOCOL_ID
Il valore dwTransportId non corrisponde a alcun trasporto supportato.

Commenti

Il parametro dwTransportId specifica anche la gestione router perché un router usa una gestione router diversa per ogni trasporto.

Requisiti

   
Client minimo supportato Nessuno supportato
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mprapi.h
Libreria Mprapi.lib
DLL Mprapi.dll

Vedi anche

MprAdminInterfaceCreate

MprAdminInterfaceTransportRemove

MprAdminServerConnect

Funzioni di amministrazione del router

Informazioni di riferimento sulla gestione dei router