Método INetSharingConfiguration::EnableSharing (netcon.h)

Artículo
03/08/2023

[El firewall de conexión a Internet puede modificarse o no estar disponible en versiones posteriores. En su lugar, use la API de Firewall de Windows.

El método EnableSharing habilita el uso compartido en esta conexión.

Sintaxis

HRESULT EnableSharing(
  [in] SHARINGCONNECTIONTYPE Type
);

Parámetros

[in] Type

Especifica si esta conexión se comparte pública o privadamente.

Valor devuelto

Si el método se ejecuta correctamente, el valor devuelto es S_OK.

Si se produce un error en el método, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto	Descripción
E_ABORT	Se anuló la operación.
E_FAIL	Se ha producido un error no especificado.
E_INVALIDARG	Uno de los parámetros no es válido.
E_NOINTERFACE	No se admite una interfaz especificada.
E_NOTIMPL	No se implementa un método especificado.
E_OUTOFMEMORY	El método no pudo asignar la memoria necesaria.
E_POINTER	Un puntero pasado como parámetro no es válido.
E_UNEXPECTED	Error en el método por motivos desconocidos.

Comentarios

Al llamar a este método, se desencadena la siguiente notificación:

%programname% está intentando habilitar el uso compartido de conexiones a Internet en la conexión de red %connectionname%. Esto permitirá que otros equipos de la red se conecten a Internet a través de una conexión pública compartida. ¿Desea que %programname% habilite el uso compartido de conexiones a Internet en esta conexión?

Si la aplicación que realiza la llamada especifica que esta conexión se comparte públicamente, cualquier conexión compartida pública anterior se deshabilita automáticamente.

Una conexión compartida públicamente automáticamente tiene habilitado el Firewall de conexión a Internet. Las conexiones compartidas de forma privada conservan su configuración existente.

Use el método INetSharingManager::get_INetSharingConfigurationForINetConnection para obtener una interfaz INetSharingConfiguration para una conexión determinada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	netcon.h
Archivo DLL	Hnetcfg.dll