Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Esta función recupera una tabla de contexto de interfaz para el nombre de host y el filtro de perfil de conexión especificados.
Sintaxis
HRESULT GetInterfaceContextTableForHostName(
[in, optional] PCWSTR HostName,
[in, optional] PCWSTR ProxyName,
[in] DWORD Flags,
[in, optional] BYTE *ConnectionProfileFilterRawData,
[in] DWORD ConnectionProfileFilterRawDataSize,
[out] NET_INTERFACE_CONTEXT_TABLE **InterfaceContextTable
);
Parámetros
[in, optional] HostName
Nombre de host de destino.
[in, optional] ProxyName
Nombre del proxy HTTP.
[in] Flags
Puede usar las marcas siguientes.
| Marca | Descripción |
| NET_INTERFACE_FLAG_NONE | Usa el comportamiento predeterminado. |
| NET_INTERFACE_FLAG_CONNECT_IF_NEEDED | Indica si la conexión subyacente debe activarse o no. |
[in, optional] ConnectionProfileFilterRawData
Blog del filtro de perfil de conexión, que es una conversión de bytes de wcm_selection_filters.
[in] ConnectionProfileFilterRawDataSize
Tamaño de ConnectionProfileFilterRawData en bytes.
[out] InterfaceContextTable
Se establece en la lista de estructuras de NET_INTERFACE_CONTEXT que contienen los índices de interfaz y los nombres de configuración que se pueden usar para el nombre de host y el filtro.
Valor devuelto
Esta función devuelve los siguientes valores HRESULT en función del estado.
| HRESULT | Descripción |
| S_OK | Se devuelve si existe una conexión que cumpla los parámetros y las directivas internas. NET_INTERFACE_CONTEXT_TABLE contendrá una lista de índices de interfaces y nombres de configuración de esas conexiones. Cuando se devuelve S_OK, se debe llamar a FreeInterfaceContextTable para liberar la tabla de contexto. |
| S_FALSE | Se devuelve para indicar que se puede usar cualquier conexión o interfaz predeterminada para este nombre de host y filtro. El NET_INTERFACE_CONTEXT_TABLE será null en este caso porque el autor de la llamada puede usar la ruta predeterminada para satisfacer los requisitos. |
| E_NOTFOUND | Esto se devuelve si no hay ninguna conexión disponible actualmente o la conexión existente no cumplen el filtro de conexión y la directiva interna para el host. El código de retorno exacto sería HRESULT(ERROR_NOT_FOUND) |
| E_INVALIDARG | Se devuelve si el autor de la llamada pasa un argumento no válido, usa una marca no admitida, tiene datos de filtro de conexión incorrectos, tamaño incorrecto o NET_INTERFACE_CONTEXT_TABLE null |
| E_OUTOFMEMORY | Esto se devuelve si no hay suficiente memoria para completar la operación. |
| FAILED(HRESULT) | Esto se devuelve debido a errores que están fuera del control de esta función. |
Requisitos
| Cliente mínimo compatible | Windows 10 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2016 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | ondemandconnroutehelper.h |
| Library | OnDemandConnRouteHelper.lib |
| Archivo DLL | OnDemandConnRouteHelper.dll |