Funzione MprConfigTransportGetHandle (mprapi.h)

Articolo
02/29/2024

La funzione MprConfigTransportGetHandle recupera un handle alla configurazione del protocollo di trasporto specificato nella configurazione del router specificata.

Sintassi

DWORD MprConfigTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterTransport
);

Parametri

[in] hMprConfig

Gestire la configurazione del router. L'handle viene ottenuto da una chiamata precedente a MprConfigServerConnect.

[in] dwTransportId

Valore DWORD che descrive il tipo di handle di configurazione del trasporto nel parametro phRouterTransport . 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] phRouterTransport

Puntatore a
Variabile HANDLE che riceve il tipo di handle di configurazione del trasporto indicato 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	Il parametro hMprConfig e/o il parametro phRouterTransport è NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_UNKNOWN_PROTOCOL_ID	Il protocollo di trasporto specificato da dwTransportId non è stato trovato nella configurazione del router.
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

Vedi anche

FormatMessage

MprConfigServerConnect

Funzioni di configurazione del router

Informazioni di riferimento sulla gestione dei router

Condividi tramite