Funzione MprAdminInterfaceTransportGetInfo (mprapi.h)
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 |
|---|---|
|
L'applicazione chiamante non dispone di privilegi sufficienti. |
|
Il valore hInterface non è valido oppure se l'interfaccia specificata è disabilitata in modo amministrativo. |
|
Il trasporto specificato non è in esecuzione nell'interfaccia specificata. |
|
Risorse insufficienti per completare l'operazione. |
|
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
MprAdminInterfaceTransportSetInfo