Funzione MprAdminInterfaceTransportGetInfo (mprapi.h)

Articolo
03/15/2023

La funzione MprAdminInterfaceTransportGetInfo recupera informazioni su un trasporto in esecuzione in un'interfaccia specificata.

Sintassi

DWORD MprAdminInterfaceTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            HANDLE            hInterface,
  [in]            DWORD             dwTransportId,
  [out]           LPBYTE            *ppInterfaceInfo,
  [out, optional] LPDWORD           lpdwInterfaceInfoSize
);

Parametri

[in] hMprServer

Gestire il router da cui vengono recuperate le informazioni. Ottenere questo handle chiamando MprAdminServerConnect.

[in] hInterface

Gestire l'interfaccia. Questo handle viene ottenuto da una chiamata precedente a MprAdminInterfaceCreate.

[in] dwTransportId

Valore DWORD che descrive il trasporto per cui sono richieste informazioni. 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

[out] ppInterfaceInfo

Puntatore a una variabile puntatore. La variabile puntatore punta a un'intestazione di informazioni che riceve informazioni per l'interfaccia e il trasporto specificati. Usare le funzioni di intestazione informazioni per modificare le intestazioni di informazioni. Liberare questa memoria chiamando MprAdminBufferFree.

[out, optional] lpdwInterfaceInfoSize

Puntatore a una variabile DWORD . Questa variabile riceve le dimensioni in byte delle informazioni sull'interfaccia restituite tramite il parametro ppInterfaceInfo .

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non restituisce le dimensioni delle informazioni sull'interfaccia.

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 oppure se l'interfaccia specificata è disabilitata in modo amministrativo.
ERROR_NO_SUCH_INTERFACE	Il trasporto specificato non è in esecuzione nell'interfaccia specificata.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_UNKNOWN_PROTOCOL_ID	Il valore dwTransportId non corrisponde ai trasporti supportati.

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

MprAdminInterfaceTransportSetInfo

MprAdminServerConnect

Funzioni di amministrazione del router

Informazioni di riferimento sulla gestione dei router

Condividi tramite