IDiscRecorder::GetDisplayNames method (imapi.h)
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 |