Funzione MprAdminTransportCreate (mprapi.h)

Articolo
02/29/2024

La funzione MprAdminTransportCreate carica un nuovo trasporto e avvia il gestore router per il trasporto.

Sintassi

DWORD MprAdminTransportCreate(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPWSTR            lpwsTransportName,
  [in]           LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in, optional] DWORD             dwClientInterfaceInfoSize,
  [in]           LPWSTR            lpwsDLLPath
);

Parametri

[in] hMprServer

Gestire il router su cui impostare le informazioni. Ottenere questo handle chiamando MprAdminServerConnect.

[in] dwTransportId

Valore DWORD che descrive il tipo di configurazione del trasporto da impostare. 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.

[in] pGlobalInfo

Puntatore a un buffer che specifica le informazioni globali per il trasporto. 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 buffer che specifica le informazioni predefinite sull'interfaccia client per il trasporto.

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non imposta le informazioni predefinite sull'interfaccia client.

[in, optional] dwClientInterfaceInfoSize

Specifica le dimensioni, in byte, del buffer a cui punta il parametro pClientInterfaceInfo .

[in] lpwsDLLPath

Puntatore a una stringa Unicode con terminazione Null che specifica il percorso della DLL per il trasporto.

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_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_INVALID_PARAMETER	Il parametro pGlobalInfo e il parametro pClientInterfaceInfo sono entrambi NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_PROTOCOL_ALREADY_INSTALLED	Il trasporto specificato è già in esecuzione sul router specificato.
ERROR_UNKNOWN_PROTOCOL_ID	Il valore dwTransportId non corrisponde ad alcun protocollo di trasporto supportato.

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

MprAdminTransportGetInfo

MprAdminTransportSetInfo

Condividi tramite