ICDBurn::Burn method (shobjidl.h)

Instructs data to be copied from the staging area to a writable CD.

Syntax

HRESULT Burn(
  [in] HWND hwnd
);

[in] hwnd

Type: HWND

The handle of the parent window of the UI.

Type: HRESULT

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

The staging area has a default location of %userprofile%\Local Settings\Application Data\Microsoft\CD Burning. Its actual path can be retrieved through SHGetFolderPath, SHGetSpecialFolderPath, SHGetFolderLocation, SHGetSpecialFolderLocation, or SHGetFolderPathAndSubDir by using the CSIDL_CDBURN_AREA value.

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