ICDBurn::HasRecordableDrive method (shobjidl.h)

Scans the system for a CD drive with write-capability, returning TRUE if one is found.

Syntax

HRESULT HasRecordableDrive(
  [out] BOOL *pfHasRecorder
);

Parameters

[out] pfHasRecorder

Type: BOOL*

A pointer to a Boolean value containing TRUE if a suitable device is located, FALSE otherwise.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This search does not rely on the state of the Enable cd writing on this drive option found on the drive's property sheet. Instead, the determination is based on IMAPI.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	shobjidl.h
DLL	Shell32.dll