Edit

IDiscRecorder::GetDisplayNames method (imapi.h)

  • Article

Retrieves a formatted name for the recorder that can be displayed. The name consists of the manufacturer and product identifier of the device.

Syntax

HRESULT GetDisplayNames(
  [out] BSTR *pbstrVendorID,
  [out] BSTR *pbstrProductID,
  [out] BSTR *pbstrRevision
);

Parameters

[out] pbstrVendorID

Vendor of the disc recorder. This parameter can be NULL.

[out] pbstrProductID

Product name of the disc recorder. This parameter can be NULL.

[out] pbstrRevision

Revision of the disc recorder. This is typically the revision of the recorder firmware, but it can be a revision for the entire device. This parameter can be NULL.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Remarks

The display names are typically combined into a string that is displayed in recorder selection list boxes or other GUI components.

The combination of these three strings does not produce a unique identifier for this specific recorder. Combine these strings with the string returned from GetPath to create a unique value.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header imapi.h
Library Uuid.lib
DLL Actxprxy.dll

See also

IDiscRecorder