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 |
---|---|
|
Il parametro hMprConfig è NULL, il parametro hRouterTransport è NULL o entrambi sono NULL. |
|
La configurazione del protocollo di trasporto corrispondente a hRouterTransport non è stata trovata nella configurazione del router. |
|
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:
- Informazioni globali.
- Informazioni sull'interfaccia predefinite per i router client.
- Nome DLL del gestore router.
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 |