3.20.9.2 IWindowsDriverUpdate::DriverHardwareID (Opnum 54)

  • Article

The IWindowsDriverUpdate::DriverHardwareID (opnum 54) method retrieves the hardware ID or compatible ID that this driver matches to be installable.

 HRESULT DriverHardwareID(
   [out, retval] BSTR* retval
 );

retval: A string specifying the hardware ID or compatible ID that this driver matches to be installable.

Return Values: The method MUST return information in an HRESULT data structure. The severity bit in the structure identifies the following conditions:

  • If the severity bit is set to 0, the method completed successfully.

  • If the severity bit is set to 1, the method failed and encountered a fatal error.

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].

This method SHOULD return the string returned by a call to the DriverHardwareID method on the IWindowsDriverUpdateEntry instance referred to by the DefaultWindowsDriverUpdateEntry ADM element.