UfnGetSystemSerialNumber (Windows Embedded CE 6.0)
1/6/2010
This function retrieves a serial number from the OAL and then verifies that the serial number adheres to Windows-based desktop platform Plug and Play restrictions.
Syntax
DWORD UfnGetSystemSerialNumber(
LPWSTR pszSerialNumber,
DWORD cchSerialNumber
);
Parameters
- pszSerialNumber
[out] Pointer to the buffer to store the serial number after verification.
- cchSerialNumber
[in] Serial number. The length of this parameter should be at least MAX_STRING_DESC_WCHARS + 1.
Return Value
If successful, the serial number is stored in pszSerialNumber, and the return value is ERROR_SUCCESS. If the function does not retrieve a valid serial number, the return value is set in the ValidateSerialNumber function, or by the GetLastError function.
Remarks
The USB function client driver helper library is in %_WINCEROOT%\Public\Common\OAK\Drivers\Usbfn\Ufnclientlib.
This function calls IOCTL_HAL_GET_UUID through KernelIoControl. Then it calls ValidateSerialNumber to verify that the identifier adheres to the Windows-based desktop platform Plug and Play restrictions.
Requirements
| Header | usbfntypes.h |
| Library | UfnClientLibBase.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
See Also
Reference
USB Function Client Driver Helper Library Functions
UfnGetRegistryInfo