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