INetSharingConfiguration::get_SharingEnabled method (netcon.h)
[Internet Connection Firewall may be altered or unavailable in subsequent versions. Instead, use the Windows Firewall API.]
The get_SharingEnabled method determines whether sharing is enabled on this connection.
Syntax
HRESULT get_SharingEnabled(
[out] VARIANT_BOOL *pbEnabled
);
Parameters
[out] pbEnabled
Pointer to a VARIANT_BOOL variable that, on successful return, specifies whether sharing is enable on this connection. If sharing is enable, this value is TRUE. Otherwise, it is FALSE.
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
To determine whether connection sharing is supported on the currently-installed operating system, use INetSharingManager::get_SharingInstalled.
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::EnableSharing
Internet Connection Sharing and Internet Connection Firewall Interfaces
Internet Connection Sharing and Internet Connection Firewall Reference