Microsoft Windows CE 3.0  

EnumPnpIds

Important:
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.

DWORD EnumDevices(
LPTSTRlpsz
PnpList, 
LPDWORD
lpBuflen
);

Parameters

lpszpnpList
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.


 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.