Método INetConnection::GetProperties (netcon.h)

[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 GetProperties recupera una estructura que contiene las propiedades de esta conexión de red.

Sintaxis

HRESULT GetProperties(
  [out] NETCON_PROPERTIES **ppProps
);

Parámetros

[out] ppProps

Puntero a un puntero que, al devolverse correctamente, apunta a una estructura de NETCON_PROPERTIES que contiene las propiedades de esta conexión de red.

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

La aplicación que realiza la llamada debe liberar la memoria ocupada por la estructura NETCON_PROPERTIES devuelta por GetProperties. Libere la memoria llamando a la función NcFreeNetconProperties . Esta función se define en NetCon.h y se exporta mediante NetShell.dll.

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

Consulte también

INetConnection

Interfaces de firewall de conexión a Internet y uso compartido de conexión a Internet

Referencia de firewall de conexión a Internet y uso compartido de conexión a Internet