DEVICE_ID
This structure allows you to uniquely identify a Windows CE device by providing two separate identifiers that are combined to create a single globally unique identifier (GUID) for the device.
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 Preset identifier is used to identify one device from another. Each device has a unique Preset identifier. The Platform identifier is used to identify one platform from another. Each platform has a unique Platform identifier. For example, two different personal digital assistants (PDAs) from the same manufacturer will have two different Preset identifiers, but have the same Platform identifier.
The DEVICE_ID structure allows you to assign platform-specific identifiers. You can set the attributes of the identifiers in any combination. For example, you can set the attributes of the Preset identifier to read-only and the attributes of the Platform identifier to read/write. It is your responsibility to ensure that the combination of Preset and Platform identifiers is unique across different products.
Requirements
OS Versions: Windows CE 2.10 and later.
Header: Pkfuncs.h.
See Also
Last updated on Wednesday, April 13, 2005
© 2005 Microsoft Corporation. All rights reserved.