Configures security mode for an Ethernet device.
- Parameters
-
| [in] | handle | Valid handle returned by SME_Initialize(). |
| [in] | securityMode | Type of encryption. |
| [in] | securityKey | Hexadecimal encryption key in ASCII format. |
- Return values
-
| 0 | Successful completion. |
| -1 | Invalid SME_Initialize() handle. |
| -2 | Invalid security mode. |
| -3 | Invalid encryption key. |
| -4 | No module selected. Call SME_SearchForModules() first. |
| -5 | Could not set device's configuration. Possible network error. |
For securityMode values, see Security Type.
The securityKey parameter must include a C String containing two hexadecimal characters per byte of encryption. For example, an AES 256 key would be represented as 64 hexadecimal characters: "0102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F20".
- Warning
- Devices with encryption enabled will not respond to broadcasts. Secured devices will not be discoverable with SME_SearchForModules() and will not be configurable with other SME methods. In order to reconfigure the device, first disable security on the device with SME_DisableDeviceSecurity().