IProgressDialog::SetLine method (shlobj_core.h)
Displays a message in the progress dialog.
HRESULT SetLine( DWORD dwLineNum, [in] PCWSTR pwzString, BOOL fCompactPath, LPCVOID pvResevered );
The line number on which the text is to be displayed. Currently there are three lines—1, 2, and 3. If the PROGDLG_AUTOTIME flag was included in the dwFlags parameter when IProgressDialog::StartProgressDialog was called, only lines 1 and 2 can be used. The estimated time will be displayed on line 3.
A null-terminated Unicode string that contains the text.
TRUE to have path strings compacted if they are too large to fit on a line. The paths are compacted with PathCompactPath.
Reserved. Set to NULL.
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
This function is typically used to display a message such as "Item XXX is now being processed." typically, messages are displayed on lines 1 and 2, with line 3 reserved for the estimated time.
|Minimum supported client||Windows 2000 Professional, Windows XP [desktop apps only]|
|Minimum supported server||Windows Server 2003 [desktop apps only]|
|DLL||Shell32.dll (version 5.0 or later)|