DEVICE_ID
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
This structure allows you to uniquely identify a Windows Embedded CE device by providing two separate identifiers that are combined to create a single globally unique identifier (GUID) for the device.
Syntax
typedef struct _DEVICE_ID {
DWORD dwSize;
DWORD dwPresetIDOffset;
DWORD dwPresetIDBytes;
DWORD dwPlatformIDOffset;
DWORD dwPlatformIDBytes;
} DEVICE_ID, *PDEVICE_ID;
Members
dwSize
Size of the allocated structure and memory for the identifiers.The caller must allocate enough memory for the structure and the identifiers.
- dwPresetIDOffset
Number of bytes from the beginning of the structure to where the Preset identifier is located.
dwPresetIDBytes
Number of bytes used to store the Preset identifier.If this value is set to zero, no Preset identifier is available.
- dwPlatformIDOffset
Number of bytes from the beginning of the structure to where the Platform identifier is located.
dwPlatformIDBytes
Number of bytes used to store the Platform identifier.If this value is set to zero, no Platform identifier is available.
Remarks
The Platform identifier is used to identify one unique hardware platform from another.
The Preset identifier is used to identify one unique device type from another.
For example, two different personal digital assistants (PDAs) from the same manufacturer have two different Platform identifiers, but they have the same Preset identifier.
You are responsible for ensuring that the combination of Preset and Platform identifiers is unique across different products.
Note
A duplicate definition of DEVICEID is declared, where applicable, under uniqueid.h.
Requirements
| Header | pkfuncs.h |
| Windows Embedded CE | Windows CE 2.10 and later |
| Note | A duplicate definition of DEVICEID is declared, where applicable, under uniqueid.h. |