IFileViewer::ShowInitialize method

Allows a file viewer to determine whether it can display a file and, if it can, to perform initialization operations before showing the file.

Syntax

c++

HRESULT ShowInitialize(
   LPFILEVIEWERSITE lpfsi
);

Parameters

• lpfsi
  Type: LPFILEVIEWERSITE

  A pointer to an IFileViewerSite interface. A file viewer uses this interface to retrieve the handle to the current pinned window or to specify a new pinned window.

Return value

Type: HRESULT

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

Remarks

The Shell calls this method before the IFileViewer::Show method. The Shell specifies the name of the file to display by calling the file viewer's IPersistFile::Load method.

ShowInitialize must perform all operations that are prone to failure so that if it succeeds, IFileViewer::Show will not fail.

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Shlobj.h
DLL	Shell32.dll (version 4.0 or later)

See also

IFileViewer