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().