Local Class Methods

AddWiFiSettings (uint32)

Method Qualifiers (AddWiFiSettings)

Name

Data Type

Value

Description

string

Shall atomically create settings that enable a WiFiEndpoint to connect to a given Wi-Fi network. These settings include the name (SSID) of the network as well as the security parameters used by the WiFiEndpoint to authenticate to the network and encrypt frames it transmits into the network and decrypt the frames it receives from the network. Upon successful completion, a new instance of CIM_WiFiEndpointSettings shall be associated to the CIM_WiFiEndpoint referenced by the WiFiEndpoint parameter, through a new instance of CIM_ElementSettingData. If the IEEE8021xSettingsInput parameter is not null, a new instance of CIM_IEEE8021xSettings containing its property values shall be associated to the new instance of CIM_WiFiEndpointSettings through a new instance of CIM_ConcreteComponent upon successful completion. Alternatively, if the IEEE8021xSettingsInputReference parameter is not null, the CIM_IEEE8021xSettings that it references shall be associated to the new instance of CIM_WiFiEndpointSettings through a new instance of CIM_ConcreteComponent upon successful completion. This method shall not apply the new settings to WiFiEndpoint. Rather, it shall make them available for subsequent manual or autonomous application.

Method Parameters (AddWiFiSettings)

Name

Type

Qualifiers

Name

Data Type

Value

IEEE8021xSettingsInput

string

Description

string

Provides the property values for a new instance of CIM_IEEE8021xSettings. If both IEEE8021xSettingsInput and IEEE8021xSettingsInputReference are not null, this method shall return 2 ("Unknown/Unspecified Error").If this parameter is not null and IEEE8021xSettingsInputReference is null, this method shall create a new CIM_IEEE8021xSettings instance with the values in this parameter, and shall associate it (through a new instance of CIM_ConcreteComponent) with the newly created instance of CIM_WiFiEndpointSettings.

EmbeddedInstance

string

CIM_IEEE8021xSettings

IN

boolean

true

WiFiEndpointSettingsInput

string

Description

string

Provides the input property values for the CIM_WiFiEndpointSettings instance that shall be created by this method. Upon successful completion of this method, a new instance of CIM_WiFiEndpointSettings shall be associated to the CIM_WiFiEndpoint referenced by the WiFiEndpoint parameter, through a new instance of CIM_ElementSettingData.

References a credential that shall be used as a trusted root certificate by the CIM_WiFiEndpoint when it authenticates the leaf certificate provided by the authentication server. This method shall return 2 ("Unknown/Unspecified Error") if IEEE8021xSettingsInput is null and IEEE8021xCredential is not null.

References a credential that shall be used to authenticate the CIM_WiFiEndpoint to a IEEE 802.1x authentication server. This method shall return 2 ("Unknown/Unspecified Error") if IEEE8021xSettingsInput is null and IEEE8021xCredential is not null.

Upon successful completion, shall contain a reference to the CIM_WiFiEndpointSettings instance created by this method.

OUT

boolean

true

UpdateWiFiSettings (uint32)

Method Qualifiers (UpdateWiFiSettings)

Name

Data Type

Value

Description

string

Shall atomically update settings that enable a WiFiEndpoint to connect to a given Wi-Fi network. These settings include the name (SSID) of the network as well as the security parameters used by the WiFiEndpoint to authenticate to the network and encrypt frames it transmits into the network and decrypt the frames it receives from the network. This method addresses the following update scenarios, each of which is given a tag line that precedes its description. Each tag line is in the form A to B, in which A indicates the type of authentication method in the settings before UpdateWiFiSettings is executed, and B indicates the type of authentication method in the settings after UpdateWiFiSettings is executed. Each of A and B is replaced in the tag lines by either "IEEE 802.1x", which indicates that the authentication method in the settings is based on IEEE 802.1x, or "Non-IEEE-802.1x", which indicates that the authentication method in the settings is not based on IEEE 802.1x.
* IEEE 802.1x to IEEE 802.1x, update all: Updating the properties of a CIM_WiFiEndpointSettings instance in which the AuthenticationMethod property indicates an IEEE 802.1x authentication method and the properties of the associated CIM_IEEE8021xSettings instance, without reverting to a non-IEEE-802.1x authentication method. In this scenario, all parameters should be not null.
* IEEE 802.1x to IEEE 802.1x, update WiFi only: Updating the properties of a CIM_WiFiEndpointSettings instance in which the AuthenticationMethod property indicates an IEEE 802.1x authentication method and that accordingly has an associated CIM_IEEE8021xSettings instance, without updating the CIM_IEEE8021xSettings instance, and without reverting to a non-IEEE-802.1x authentication method. In this scenario, the IEEE8021xSettingsInput parameter should be null and all other parameters should be not null.
* IEEE 802.1x to IEEE 802.1x, update IEEE 802.1x only: Updating the properties of a CIM_IEEE8021xSettings instance that has an associated CIM_WiFiEndpointSettings instance without updating the CIM_WiFiEndpointSettings instance. In this scenario, the WiFiEndpointSettingsInput parameter should be null and all other parameters should be not null.
* Non-IEEE-802.1x to Non-IEEE-802.1x: Updating the properties of a CIM_WiFiEndpointSettings instance in which the AuthenticationMethod property indicates a non-IEEE-802.1x authentication method, and that accordingly does not have an associated CIM_IEEE8021xSettings instance, without changing the authentication method to an IEEE 802.1x method. In this scenario, the WiFiEndpointSettings and WiFiEndpointSettingsInput parameters should be not null, and the IEEE8021xSettings and IEEE8021xSettingsInput parameters should be null.
* Non-IEEE-802.1x to IEEE 802.1x: Updating the properties of a CIM_WiFiEndpointSettings instance in which the AuthenticationMethod property indicates a non-IEEE-802.1x authentication method, and that accordingly does not have an associated CIM_IEEE8021xSettings instance, and changing the authentication method to an IEEE 802.1x method. In this scenario, the IEEE8021xSettingsInput parameter should be null, and all other parameters should be not null. An instance of CIM_IEEE8021xSettings should first be created using the intrinsic method CreateInstance. Then, this method should be used with all parameters except IEEE8021xSettingsInput not null. This method shall update WiFiEndpointSettings and create a new instance of CIM_ConcreteComponent between WiFiEndpointSettings and IEEE8021xSettings.
* IEEE 802.1x to Non-IEEE-802.1x: Updating the properties of a CIM_WiFiEndpointSettings instance in which the AuthenticationMethod property indicates an IEEE 802.1x authentication method and that accordingly has an associated CIM_IEEE8021xSettings instance, and reverting to a non-IEEE-802.1x authentication method. In this scenario, the IEEE8021xSettingsInput should be null, and all other parameters should be not null. This method shall delete the CIM_ConcreteComponent instance between the instances referenced by the WiFiEndpointSettings and IEEE8021xSettings parameters. If this CIM_ConcreteComponent instance is the last CIM_ConcreteComponent instance that references the CIM_IEEE8021xSettings instance referenced by the IEEE8021xSettings parameter, and the instance of CIM_IEEE8021xSettings referenced by the IEEE8021xSettings parameter was created by AddWiFiEndpointSettings, then this method shall also delete this CIM_IEEE8021xSettings instance.
This method shall not apply the updated settings to any instance of CIM_WiFiEndpoint.

Method Parameters (UpdateWiFiSettings)

Name

Type

Qualifiers

Name

Data Type

Value

IEEE8021xSettingsInput

string

Description

string

If not null, shall provide the new property values for the instance of CIM_IEEE8021xSettings referenced by the IEEE8021xSettings parameter. If the IEEE8021xSettings is null and the IEEE8021xSettingsInput parameter is not null, this method shall return 2 ("Unknown/Unspecified Error").

EmbeddedInstance

string

CIM_IEEE8021xSettings

IN

boolean

true

WiFiEndpointSettingsInput

string

Description

string

If not null, shall provide the new property values for the instance of CIM_WiFiEndpointSettings referenced by the WiFiEndpointSettings parameter.