Advances the internal pointer to the first discovered module whose MAC address matches the parameter.
- Parameters:
-
| [in] | handle | Valid handle returned by SME_Initialize(). |
| [in] | mac | In the form "xx-xx-xx-xx-xx-xx" |
- Return values:
-
| 0 | Successful completion. |
| -1 | Invalid SME_Initialize handle. |
| -2 | No modules have been found. See SME_SearchForModules(). |
| -3 | Could not locate named module. |
| -4 | Invalid MAC address parameter. |
Attempts to search for the first module whose MAC address matches the 'mac' string parameter. If SME_ModuleByMAC fails, the currently select module (if any) remains selected.
- Note:
- The mac parameter should be null terminated.