Funzione MprConfigInterfaceTransportSetInfo (mprapi.h)

Articolo
03/15/2023

La funzione MprConfigInterfaceTransportSetInfo aggiorna le informazioni di configurazione per il client nell'interfaccia e nel protocollo di trasporto specificati.

Sintassi

DWORD MprConfigInterfaceTransportSetInfo(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           HANDLE hRouterIfTransport,
  [in, optional] LPBYTE pInterfaceInfo,
  [in, optional] DWORD  dwInterfaceInfoSize
);

Parametri

[in] hMprConfig

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

[in] hRouterInterface

Gestire la configurazione dell'interfaccia in cui aggiornare le informazioni. Ottenere questo handle chiamando MprConfigInterfaceCreate o MprConfigInterfaceEnum.

[in] hRouterIfTransport

Gestire la configurazione del trasporto in cui aggiornare le informazioni per il client. Ottenere questo handle chiamando MprConfigInterfaceTransportAdd, MprConfigInterfaceTransfaceTransportGetHandle o MprConfigInterfaceTransportEnum. I tipi di protocollo di trasporto supportati sono elencati in Identificatori di trasporto.

[in, optional] pInterfaceInfo

Puntatore a un'intestazione di informazioni che contiene informazioni di configurazione per il client nell'interfaccia e nel trasporto specificati. Il gestore router per il trasporto specificato interpreta queste informazioni. Usare le funzioni di intestazione informazioni per modificare le intestazioni di informazioni.

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non aggiorna le informazioni di configurazione per il client.

[in, optional] dwInterfaceInfoSize

Specifica le dimensioni, in byte, dei dati a cui fa riferimento pInterfaceInfo.

Questo parametro è facoltativo; l'applicazione chiamante può specificare zero per questo parametro. Tuttavia, se pInterfaceInfo non è NULL, questo parametro non può essere zero. Per ulteriori informazioni, vedere la sezione Osservazioni di seguito in questo argomento.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR. Per ulteriori informazioni, vedere la sezione Osservazioni di seguito in questo argomento.

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. hRouterIfTransport è NULL.
ERROR_NO_SUCH_INTERFACE	L'interfaccia specificata da hRouterInterface non è più presente nella configurazione del router o il trasporto specificato da hRouterInterface non è più presente nell'interfaccia.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Commenti

Se il parametro pInterfaceInfo è NULL, MprConfigInterfaceTransportSetInfo non fa nulla e restituisce immediatamente con un valore di NO_ERROR.

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