Condividi tramite


Funzione MprConfigTransportSetInfo (mprapi.h)

La funzione MprConfigTransportSetInfo modifica la configurazione per il protocollo di trasporto specificato nella configurazione del router specificata.

Sintassi

DWORD MprConfigTransportSetInfo(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterTransport,
  [in, optional] LPBYTE pGlobalInfo,
  [in, optional] DWORD  dwGlobalInfoSize,
  [in, optional] LPBYTE pClientInterfaceInfo,
  [in, optional] DWORD  dwClientInterfaceInfoSize,
  [in, optional] LPWSTR lpwsDLLPath
);

Parametri

[in] hMprConfig

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

[in] hRouterTransport

Gestire la configurazione del protocollo di trasporto da aggiornare. Ottenere questo handle chiamando MprConfigTransportCreate, MprConfigTransportGetHandle o MprConfigTransportEnum. I tipi di protocollo di trasporto supportati sono elencati in Identificatori di trasporto.

[in, optional] pGlobalInfo

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

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

[in, optional] dwGlobalInfoSize

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

[in, optional] pClientInterfaceInfo

Puntatore a un'intestazione di informazioni che specifica le informazioni predefinite sull'interfaccia per i router client. Le informazioni vengono usate per configurare interfacce dinamiche per i router client per questo trasporto. Usare le funzioni di intestazione informazioni per modificare le intestazioni di 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 fa riferimento 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.

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

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
Il parametro hMprConfig è NULL, il parametro hRouterTransport è NULL o entrambi sono NULL.
ERROR_UNKNOWN_PROTOCOL_ID
La configurazione del protocollo di trasporto corrispondente a hRouterTransport non è stata trovata nella configurazione del router.
Altri
Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.
 
 

Commenti

Usare MprConfigTransportSetInfo per impostare le informazioni globali del trasporto, le informazioni predefinite sull'interfaccia o il nome della DLL di gestione router per il trasporto.

MprConfigTransportSetInfo tenta di impostare gli elementi nell'ordine in cui vengono visualizzati nell'elenco dei parametri:

  1. Informazioni globali.
  2. Informazioni sull'interfaccia predefinite per i router client.
  3. Nome DLL del gestore router.
Se MprConfigTransportSetInfo non è in grado di impostare uno degli elementi, restituisce immediatamente senza tentare di impostare gli elementi rimanenti.

Se i parametri pGlobalInfo, pClientInterfaceInfo e lpwsDLLPath sono tutti NULL, la funzione non restituisce alcun valore di NO_ERROR.

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

MprConfigTransportCreate

MprConfigTransportEnum

MprConfigTransportGetHandle

Funzioni di configurazione del router

Informazioni di riferimento sulla gestione dei router