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

[アーティクル]
03/02/2024

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

メモ Windows Vista では、オンライン印刷ウィザードはサポートされなくなりました。ただし、このメソッドは引き続きネットワーク配置の追加ウィザードを生成するために使用できます。

構文

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を返し、それ以外の場合は次のようなエラー値を返します。

リターンコード説明

リターンコード	説明
E_INVALIDARG	Windows Vista では、pszServiceProvider を渡`InternetPhotoPrinting`すことによって、サポートされていないオンライン印刷ウィザードを初期化しようとする可能性があります。 Windows XP では、オンライン印刷ウィザードを初期化するときに、 pdo パラメーターが NULL であるか、空の選択範囲を指していることを示す場合があります。
E_NOTIMPL	pszServiceProvider パラメーターがサポートされている値の 1 つではないか、dwOptions パラメーターにサポートされていないフラグの組み合わせが含まれています。

E_INVALIDARG

Windows Vista では、pszServiceProvider を渡InternetPhotoPrintingすことによって、サポートされていないオンライン印刷ウィザードを初期化しようとする可能性があります。

Windows XP では、オンライン印刷ウィザードを初期化するときに、 pdo パラメーターが NULL であるか、空の選択範囲を指していることを示す場合があります。

E_NOTIMPL

pszServiceProvider パラメーターがサポートされている値の 1 つではないか、dwOptions パラメーターにサポートされていないフラグの組み合わせが含まれています。

注釈

発行ウィザードオブジェクトによって実装される 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 トピックを参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	shobjidl.h
[DLL]	Netplwiz.dll