Funzione MprConfigInterfaceTransportAdd (mprapi.h)

Articolo
03/15/2023

La funzione MprConfigInterfaceTransportAdd aggiunge un protocollo di trasporto a una configurazione dell'interfaccia nel router.

Sintassi

DWORD MprConfigInterfaceTransportAdd(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pInterfaceInfo,
  [in]           DWORD  dwInterfaceInfoSize,
  [out]          HANDLE *phRouterIfTransport
);

Parametri

[in] hMprConfig

Gestire la configurazione del router. Ottenere questo handle chiamando MprConfigServerConnect.

[in] hRouterInterface

Gestire la configurazione dell'interfaccia a cui viene aggiunto il trasporto specificato. Ottenere questo handle chiamando MprConfigInterfaceCreate, MprConfigInterfaceGetHandle o MprConfigInterfaceEnum.

[in] dwTransportId

Valore DWORD che descrive il trasporto da aggiungere alla configurazione. Questo parametro identifica anche il gestore router per il trasporto. 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, optional] lpwsTransportName

Puntatore a una stringa Unicode con terminazione null che specifica il nome per il trasporto da aggiungere. Se questo parametro non è specificato e il trasporto è IP o IPX, MprConfigInterfaceTransportAdd usa IP o IPX. Se questo parametro non è specificato e il trasporto è diverso da IP o IPX, MprConfigInterfaceTransportAdd converte il parametro dwTransportId in una stringa e lo usa come nome di trasporto.

[in] pInterfaceInfo

Puntatore a un'intestazione di informazioni che contiene informazioni per l'interfaccia e il trasporto specificati. Il gestore router per il trasporto specificato interpreta queste informazioni. Usare le funzioni di intestazione informazioni per modificare le intestazioni di informazioni.

[in] dwInterfaceInfoSize

Specifica le dimensioni, in byte, dei dati a cui fa riferimento pInterfaceInfo.

[out] phRouterIfTransport

Puntatore a
Variabile HANDLE che riceve il tipo di handle di configurazione del trasporto per questa interfaccia indicata nel parametro dwTransportId.

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_INVALID_PARAMETER	Una delle seguenti condizioni è vera: hMprConfig è NULL. hRouterInterface è NULL. phRouterIfTransport è NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Commenti

Oltre a specificare un trasporto, il parametro dwTransportId specifica anche una gestione router, perché un router gestisce un gestore router univoco per ogni trasporto.

Se il trasporto specificato esiste già, MprConfigInterfaceTransportAdd equivale a una chiamata MprConfigInterfaceTransportSetInfo usando i valori dei parametri specificati.

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