Funzione MprConfigInterfaceTransportGetHandle (mprapi.h)

Articolo
02/29/2024

La funzione MprConfigInterfaceTransportGetHandle recupera un handle per la configurazione del trasporto di un'interfaccia nella configurazione del router specificata.

Sintassi

DWORD MprConfigInterfaceTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  HANDLE hRouterInterface,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterIfTransport
);

Parametri

[in] hMprConfig

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

[in] hRouterInterface

Gestire la configurazione dell'interfaccia. Ottenere questo handle chiamando MprConfigInterfaceCreate, MprConfigInterfaceGetHandle o MprConfigInterfaceEnum.

[in] dwTransportId

Valore DWORD che descrive il tipo di handle di configurazione del trasporto nel parametro phRouterIfTransport . 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] 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	Almeno uno dei seguenti è vero: hMprConfig è NULL. hRouterInterface è NULL. phRouterIfTransport è NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_NO_SUCH_INTERFACE	L'interfaccia specificata da hRouterInterface non è stata trovata nella configurazione del router o il trasporto specificato da dwTransportId non è stato abilitato nell'interfaccia specificata.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Requisiti

Requisito	Valore
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