IPublishingWizard::Initialize-Methode (shobjidl.h)

Artikel
08/26/2023

Initialisiert das Veröffentlichungs-Assistent-Objekt mit den zu übertragenden Dateien, den zu verwendenden Einstellungen und dem Typ des zu erstellenden Assistenten.

Hinweis Windows Vista unterstützt den Onlinedruck-Assistenten nicht mehr. Diese Methode kann jedoch weiterhin verwendet werden, um den Assistenten zum Hinzufügen von Netzwerkplatz zu generieren.

Syntax

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

Parameter

[in] pdo

Typ: IDataObject*

Ein Zeiger auf einen instance von IDataObject, der die zu übertragenden Dateien oder Ordner darstellt, wenn pszServiceProvider istInternetPhotoPrinting. Wenn pszServiceProvider ist AddNetPlace, ist dieser Parameter NULL.

[in] dwOptions

Art: DWORD

Eine Kombination der folgenden Flags.

SHPWHF_NORECOMPRESS

Lassen Sie keine erneute Verdichtung von Bilddaten zu. Zur Verwendung mit dem Onlinedruck-Assistenten.

SHPWHF_NONETPLACECREATE

Erstellen Sie keine Netzwerkplatzverknüpfung, wenn die Datenübertragung abgeschlossen ist. Dieses Flag ist für die Verwendung mit dem Assistenten zum Hinzufügen von Netzwerkorten vorgesehen.

SHPWHF_NOFILESELECTOR

Erlauben Sie dem Benutzer nicht, die Dateiauswahl im Assistenten zu ändern.

SHPWHF_USEMRU

Wird nicht unterstützt.

SHPWHF_ANYLOCATION

Windows Vista und höher. Zur Verwendung mit dem Assistenten zum Hinzufügen von Netzwerkplatz. Wenn dieses Flag festgelegt ist und pszServiceProvider ist AddNetPlace, zeigt der Assistent zum Hinzufügen von Netzwerkplatz eine Option zum Auswählen eines anderen Netzwerkstandorts als die Standorte oder Anbieter an, die im Assistenten angezeigt werden sollen.

SHPWHF_VALIDATEVIAWEBFOLDERS

Zur Verwendung mit dem Assistenten zum Hinzufügen von Netzwerkplatz. Wenn in Windows XP dieses Flag festgelegt ist und der Versuch, den Netzwerkspeicherort mithilfe von WebDAV zu öffnen, fehlschlägt, versucht der Assistent zum Hinzufügen von Netzwerkplatz, einen Webordner für den Speicherort mithilfe der Unterstützung für WEC zu erstellen. In Windows Vista und Windows Server 2003 hat dieses Flag keine Auswirkungen, und Netzwerkstandorte ohne Unterstützung für WebDAV werden möglicherweise nicht als Webordner geöffnet.

[in] pszServiceScope

Typ: LPCWSTR

Unicode-Zeichenfolge, die den Typ des anzuzeigenden Assistenten angibt. Die folgenden Werte, bei denen die Groß-/Kleinschreibung beachtet wird, werden in Windows Vista unterstützt.

AddNetPlace

Initialisieren Sie den Assistenten zum Hinzufügen von Netzwerkplatz.

InternetPhotoPrinting

Initialisieren Sie den Onlinedruck-Assistenten. Wird in Windows Vista nicht unterstützt.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn erfolgreich oder ein Fehlerwert andernfalls wie folgt angegeben ist:

Rückgabecode	Beschreibung
E_INVALIDARG	In Windows Vista kann ein Versuch angegeben werden, den nicht unterstützten Onlinedruck-Assistenten zu initialisieren, indem sie pszServiceProvider übergeben`InternetPhotoPrinting`. In Windows XP kann angegeben werden, dass beim Initialisieren des Onlinedruck-Assistenten der pdo-ParameterNULL ist oder auf eine leere Auswahl verweist.
E_NOTIMPL	Der Parameter pszServiceProvider ist keiner der unterstützten Werte, oder der dwOptions-Parameter enthält eine nicht unterstützte Kombination von Flags.

Hinweise

IPublishingWizard::Initialize, das von einem Veröffentlichungs-Assistenten-Objekt implementiert wird, wird aufgerufen, um das Assistentenobjekt zu initialisieren.

Das folgende Beispiel funktioniert nicht unter Windows Vista, da der Onlinedruck-Assistent nicht über IPublishingWizard in Windows Vista instanziiert werden kann.

/* 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 zeigt den initialisierten Assistenten nicht tatsächlich an. Informationen zum Anzeigen des Assistenten finden Sie im Thema IPublishingWizard .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl.h
DLL	Netplwiz.dll

Share via