INetSharingConfiguration::EnableSharing method (netcon.h)
[Internet Connection Firewall may be altered or unavailable in subsequent versions. Instead, use the Windows Firewall API.]
The EnableSharing method enables sharing on this connection.
Syntax
HRESULT EnableSharing(
[in] SHARINGCONNECTIONTYPE Type
);
Parameters
[in] Type
Specifies whether this connection is shared publicly or privately.
Return value
If the method succeeds the return value is S_OK.
If the method fails, the return value is one of the following error codes.
Return code | Description |
---|---|
|
The operation was aborted. |
|
An unspecified error occurred. |
|
One of the parameters is invalid. |
|
A specified interface is not supported. |
|
A specified method is not implemented. |
|
The method was unable to allocate required memory. |
|
A pointer passed as a parameter is not valid. |
|
The method failed for unknown reasons. |
Remarks
Calling this method triggers the following notification:
%programname% is attempting to enable Internet Connection Sharing on the network connection %connectionname%. This will allow other computers on your network to connect to the Internet through a shared public connection. Do you want %programname% to enable Internet Connection Sharing on this connection?
If the calling application specifies that this connection is publicly shared, any previous publicly-shared connection is automatically disabled.
A publicly-shared connection automatically has Internet Connection Firewall enabled. Privately-shared connections retain their existing settings.
Use the INetSharingManager::get_INetSharingConfigurationForINetConnection method to obtain an INetSharingConfiguration interface for a particular connection.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | None supported |
Target Platform | Windows |
Header | netcon.h |
DLL | Hnetcfg.dll |
See also
INetSharingConfiguration::DisableSharing
INetSharingConfiguration::get_SharingEnabled
Internet Connection Sharing and Internet Connection Firewall Interfaces
Internet Connection Sharing and Internet Connection Firewall Reference