IPhotoAcquireOptionsDialog::Initialize method (photoacquire.h)

Initializes the options dialog box and reads any saved options from the registry.

Syntax

HRESULT Initialize(
  [in] LPCWSTR pszRegistryRoot
);

Parameters

[in] pszRegistryRoot

(optional) Pointer to a null-terminated string containing the registry root of a custom location to read the acquisition settings from. If this parameter is set to NULL, the default location will be used.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.

Remarks

Initialize must be called prior to calling Create or DoModal. Failure to do so will cause Create or DoModal to fail.

If Initialize is called while the options dialog box is already displayed, an error will be returned.

Requirements

Requirement Value
Target Platform Windows
Header photoacquire.h
Library PhotoAcquireUID.lib

See also

IPhotoAcquireOptionsDialog Interface