Expand Minimize

CM_Get_Device_Interface_List_Size function

The CM_Get_Device_Interface_List_Size function retrieves the buffer size that must be passed to the CM_Get_Device_Interface_List function.

Syntax


CMAPI
CONFIGRET
WINAPI CM_Get_Device_Interface_List_Size(
  _Out_     PULONG pulLen,
  _In_      LPGUID InterfaceClassGuid,
  _In_opt_  DEVINSTID_W pDeviceID,
  _In_      ULONG ulFlags
);

Parameters

pulLen [out]

Caller-supplied pointer to a location that receives the required length, in characters, of a buffer to hold the multiple Unicode strings that will be returned by CM_Get_Device_Interface_List.

InterfaceClassGuid [in]

Supplies a GUID that identifies a device interface class.

pDeviceID [in, optional]

Caller-supplied pointer to a NULL-terminated string that represents a device instance ID. If specified, the function retrieves the length of symbolic link names for the device interfaces that are supported by the device, for the specified class. If this value is NULL, or if it points to a zero-length string, the function retrieves the length of symbolic link names for all interfaces that belong to the specified class.

ulFlags [in]

Contains one of the following caller-supplied flags:

CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES

The function provides the size of a list that contains device interfaces associated with all devices that match the specified GUID and device instance ID, if any.

CM_GET_DEVICE_INTERFACE_LIST_PRESENT

The function provides the size of a list containing device interfaces associated with devices that are currently active, and which match the specified GUID and device instance ID, if any.

Return value

If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the error codes with the CR_ prefix as defined in Cfgmgr32.h.

Requirements

Version

Available in Microsoft Windows 2000 and later versions of Windows.

Header

Cfgmgr32.h (include Cfgmgr32.h)

Library

Cfgmgr32.lib

See also

CM_Get_Device_Interface_List

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft