This is retired content. This content is outdated and is no
longer being maintained. It is provided as a courtesy for
individuals who are still using these technologies. This content
may contain URLs that were valid when originally published, but now
link to sites or pages that no longer exist.
This function returns a list of the Plug-and-Play IDs that are
currently active in the system.
A list of null-terminated strings. The list is terminated with
two consecutive null characters, one terminating the last entry in
the list plus an additional null. For example,
"MEGAHERTZ-XJ2288-9E81\0XIRCOM-X2250-F877\0\0".
lpBufLen
A pointer to a DWORD containing the length of the
lpszPnpListbuffer, allocated by the caller. If the buffer is
too small to hold the entire list, then
EnumPnpIdswill store the necessary buffer size in
lpBufLen.
Return Values
ERROR_SUCCESS
The function returned successfully.
ERROR_INSUFFICIENT_BUFFER
The
lpszPnpListbuffer was not big enough to hold any entries;
lpBufLenwill contain the required size.
ERROR_INVALID_PARAMETER
The
lpBufLenparameter was NULL.
ERROR_MORE_DATA
The
lpszPnpListbuffer was not big enough to hold the complete
list of active Plug-and-Play IDs;
lpBufLenwill contain the required size.
ERROR_NO_MORE_DEVICES
EnumPnpIdsfailed to find any active Plug-and-Play IDs.
Requirements
Runs on
Versions
Defined in
Include
Link to
Windows CE OS
1.0 and later
Note This API is part of the
complete Windows CE OS package as provided by Microsoft. The
functionality of a particular platform is determined by the
original equipment manufacturer (OEM) and some devices may not
support this API.