Funzione MprConfigTransportCreate (mprapi.h)

Articolo
03/15/2023

La funzione MprConfigTransportCreate aggiunge il trasporto specificato all'elenco dei protocolli di trasporto presenti nella configurazione del router specificata.

Sintassi

DWORD MprConfigTransportCreate(
  [in]           HANDLE hMprConfig,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pGlobalInfo,
  [in]           DWORD  dwGlobalInfoSize,
  [in, optional] LPBYTE pClientInterfaceInfo,
  [in, optional] DWORD  dwClientInterfaceInfoSize,
  [in, optional] LPWSTR lpwsDLLPath,
  [out]          HANDLE *phRouterTransport
);

Parametri

[in] hMprConfig

Gestire la configurazione del router a cui aggiungere il trasporto. Ottenere questo handle chiamando MprConfigServerConnect.

[in] dwTransportId

Valore DWORD che descrive il trasporto da aggiungere alla configurazione. Questo parametro identifica anche la gestione router per il trasporto. 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] lpwsTransportName

Puntatore a una stringa Unicode con terminazione Null che specifica il nome del trasporto da aggiungere. Se questo parametro non viene specificato, il parametro dwTransportId viene convertito in una stringa e usato come nome di trasporto.

[in] pGlobalInfo

Puntatore a un'intestazione di informazioni che specifica le informazioni globali per il trasporto. Il gestore router per il trasporto interpreta queste informazioni. Usare le funzioni di intestazione delle informazioni per modificare le intestazioni delle informazioni.

[in] dwGlobalInfoSize

Specifica le dimensioni, in byte, dei dati a cui punta il parametro pGlobalInfo .

[in, optional] pClientInterfaceInfo

Puntatore a un'intestazione di informazioni che specifica le informazioni di interfaccia predefinite per i router client. Queste informazioni vengono usate per configurare le interfacce dinamiche per i router client per questo trasporto. Usare le funzioni di intestazione delle informazioni per modificare le intestazioni delle informazioni.

Questo parametro è facoltativo; l'applicazione chiamante può specificare NULL per questo parametro.

[in, optional] dwClientInterfaceInfoSize

Specifica le dimensioni, in byte, dei dati a cui punta il parametro pClientInterfaceInfo . Se l'applicazione chiamante specifica NULL per pClientInterfaceInfo, l'applicazione chiamante deve specificare zero per questo parametro.

[in, optional] lpwsDLLPath

Puntatore a una stringa Unicode con terminazione Null che specifica il nome della DLL di gestione router per il trasporto specificato. Se questo nome viene specificato, la funzione imposta il percorso DLL per questo trasporto su questo nome.

Questo parametro è facoltativo; l'applicazione chiamante può specificare NULL per questo parametro.

[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 viene 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 è NULL oppure il parametro phRouterTransport è NULL oppure entrambi sono NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Commenti

Se il trasporto specificato esiste già, MprConfigTransportCreate esegue l'equivalente di una chiamata MprConfigTransportSetInfo usando i valori dei parametri specificati.

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

FormatMessage

MprConfigServerConnect

Funzioni di configurazione del router

Informazioni di riferimento sulla gestione dei router

Condividi tramite