Funzione MprAdminInterfaceTransportSetInfo (mprapi.h)

La funzione MprAdminInterfaceTransportSetInfo imposta informazioni per un trasporto in esecuzione in un'interfaccia specificata.

Sintassi

DWORD MprAdminInterfaceTransportSetInfo(
  [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 è in corso l'impostazione del trasporto. Ottenere l'handle chiamando MprAdminServerConnect.

[in] hInterface

Gestire l'interfaccia in cui è impostato il trasporto. Ottenere questo handle chiamando MprAdminInterfaceCreate.

[in] dwTransportId

Valore DWORD che descrive il tipo di trasporto da impostare. 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 contiene informazioni per l'interfaccia e il trasporto specificati. 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_NO_SUCH_INTERFACE	Il trasporto specificato non è in esecuzione nell'interfaccia specificata.
ERROR_UNKNOWN_PROTOCOL_ID	Il valore dwTransportId non corrisponde a alcun trasporto supportato.

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

MprAdminInterfaceTransportGetInfo

MprAdminServerConnect

Funzioni di amministrazione del router

Informazioni di riferimento sulla gestione dei router