Funzione MprAdminTransportSetInfo (mprapi.h)

Articolo
08/24/2023

La funzione MprAdminTransportSetInfo imposta informazioni globali, informazioni sull'interfaccia client predefinite o entrambe, per un trasporto specificato.

Sintassi

DWORD MprAdminTransportSetInfo(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in]           DWORD             dwClientInterfaceInfoSize
);

Parametri

[in] hMprServer

Gestire sul router in cui vengono impostate le informazioni. Questo handle viene ottenuto da una chiamata precedente a MprAdminServerConnect.

[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	Protocollo Internet versione 4
PID_IPX	Scambio di pacchetti Internet
PID_NBF	Protocollo NetBIOS Frames
PID_IPV6	Windows Server 2008 o versione successiva: Protocollo Internet versione 6

[in, optional] pGlobalInfo

Puntatore a un buffer che specifica le informazioni globali per il trasporto. Usare le funzioni di intestazione delle informazioni per modificare le intestazioni delle informazioni.

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non imposta le informazioni globali.

[in] dwGlobalInfoSize

Specifica le dimensioni, in byte, del buffer a cui punta il parametro pGlobalInfo .

[in, optional] pClientInterfaceInfo

Puntatore a un buffer che specifica le informazioni predefinite sull'interfaccia client per il trasporto.

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non imposta le informazioni predefinite sull'interfaccia client.

[in] dwClientInterfaceInfoSize

Specifica le dimensioni, in byte, del buffer a cui punta il parametro pClientInterfaceInfo .

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	Significato
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_INVALID_PARAMETER	Il parametro pGlobalInfo e il parametro pClientInterfaceInfo sono entrambi NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_UNKNOWN_PROTOCOL_ID	Il valore dwTransportId non corrisponde ad alcun protocollo di 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

MprAdminServerConnect

MprAdminTransportGetInfo

Funzioni di amministrazione router

Informazioni di riferimento sulla gestione dei router

Condividi tramite