IPublishingWizard::Initialize メソッド (shobjidl.h)

転送するファイル、使用する設定、作成するウィザードの種類を使用して、発行ウィザード オブジェクトを初期化します。

構文

HRESULT Initialize(
  [in] IDataObject *pdo,
  [in] DWORD       dwOptions,
  [in] LPCWSTR     pszServiceScope
);

パラメーター

[in] pdo

型: IDataObject*

pszServiceProviderInternetPhotoPrintingが の場合、転送するファイルまたはフォルダーを表す IDataObject のインスタンスへのポインター。 pszServiceProvider が のAddNetPlace場合、このパラメーターは NULL です。

[in] dwOptions

型: DWORD

次のフラグの組み合わせ。

SHPWHF_NORECOMPRESS

画像データの再圧縮を許可しないでください。 オンライン印刷ウィザードで使用します。

SHPWHF_NONETPLACECREATE

データ転送が完了した場合は、ネットワークの場所のショートカットを作成しないでください。 このフラグは、ネットワーク配置の追加ウィザードで使用します。

SHPWHF_NOFILESELECTOR

ユーザーがウィザード内でファイルの選択を変更できないようにします。

SHPWHF_USEMRU

サポートされていません。

SHPWHF_ANYLOCATION

Windows Vista 以降。 ネットワーク配置の追加ウィザードで使用します。 このフラグが設定され、 pszServiceProvider が の AddNetPlace場合、ネットワーク配置の追加ウィザードには、ウィザードに表示するために登録されている場所またはプロバイダー以外のネットワークの場所を選択するオプションが表示されます。

SHPWHF_VALIDATEVIAWEBFOLDERS

ネットワーク配置の追加ウィザードで使用します。 Windows XP では、このフラグが設定されていて、WebDAV を使用してネットワークの場所を開こうとすると、ネットワーク配置の追加ウィザードは WEC のサポートを使用して、その場所の Web フォルダーの作成を試みます。 Windows Vista および Windows Server 2003 では、このフラグは影響を受けず、WebDAV をサポートしないネットワークの場所を Web フォルダーとして開くことができない場合があります。

[in] pszServiceScope

種類: LPCWSTR

表示するウィザードの種類を示す Unicode 文字列。 Windows Vista では、次の大文字と小文字を区別する値がサポートされています。

AddNetPlace

ネットワーク配置の追加ウィザードを初期化します。

InternetPhotoPrinting

オンライン印刷ウィザードを初期化します。 Windows Vista ではサポートされていません。

戻り値

種類: HRESULT

成功した場合はS_OKを返し、それ以外の場合は次のようなエラー値を返します。

注釈

発行ウィザード オブジェクトによって実装される IPublishingWizard::Initialize は、ウィザード オブジェクトを初期化するために呼び出されます。

次の例は、Windows Vista で IPublishingWizard を使用してオンライン印刷ウィザードをインスタンス化できないため、Windows Vista では機能しません。

/* initializing the Online Print Wizard in Windows XP or Windows 2003 Server*/
hr = pPublish->Initialize(pDataObject,  // A data object that represents files or 
                                        // folders to transfer.
                          SHPWHF_NOFILESELECTOR,     // Flags
                          L"InternetPhotoPrinting"); // Display the Online Print Wizard.

IPublishingWizard::Initialize では、初期化されたウィザードは実際には表示されません。 ウィザードの表示方法については、 IPublishingWizard トピックを参照してください。

要件