Función MprAdminTransportSetInfo (mprapi.h)
La función MprAdminTransportSetInfo establece información global, o información de interfaz de cliente predeterminada, o ambas, para un transporte especificado.
Sintaxis
DWORD MprAdminTransportSetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] DWORD dwTransportId,
[in, optional] LPBYTE pGlobalInfo,
[in] DWORD dwGlobalInfoSize,
[in, optional] LPBYTE pClientInterfaceInfo,
[in] DWORD dwClientInterfaceInfoSize
);
Parámetros
[in] hMprServer
Controle al enrutador en el que se va a establecer la información. Este identificador se obtiene de una llamada anterior a MprAdminServerConnect.
[in] dwTransportId
Valor DWORD que describe el tipo de transporte que se va a establecer. Los valores aceptables para dwTransportId se enumeran en la tabla siguiente.
| Valor | Transporte (familia de protocolos) |
|---|---|
| PID_ATALK | Appletalk |
| PID_IP | Protocolo de Internet versión 4 |
| PID_IPX | Intercambio de paquetes de Internet |
| PID_NBF | Protocolo de marcos NetBIOS |
| PID_IPV6 | Windows Server 2008 o posterior: Protocolo de Internet versión 6 |
[in, optional] pGlobalInfo
Puntero a un búfer que especifica información global para el transporte. Use las funciones de encabezado de información para manipular encabezados de información.
Este parámetro es opcional. Si la aplicación que realiza la llamada especifica NULL para este parámetro, la función no establece la información global.
[in] dwGlobalInfoSize
Especifica el tamaño, en bytes, del búfer al que apunta el parámetro pGlobalInfo .
[in, optional] pClientInterfaceInfo
Puntero a un búfer que especifica información de interfaz de cliente predeterminada para el transporte.
Este parámetro es opcional. Si la aplicación que realiza la llamada especifica NULL para este parámetro, la función no establece la información predeterminada de la interfaz de cliente.
[in] dwClientInterfaceInfoSize
Especifica el tamaño, en bytes, del búfer al que apunta el parámetro pClientInterfaceInfo .
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
La aplicación que realiza la llamada no tiene privilegios suficientes. |
|
El parámetro pGlobalInfo y el parámetro pClientInterfaceInfo son NULL. |
|
Recursos insuficientes para completar la operación. |
|
El valor dwTransportId no coincide con ningún protocolo de transporte admitido. |
Requisitos
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mprapi.h |
| Library | Mprapi.lib |
| Archivo DLL | Mprapi.dll |