IPublishingWizard ::Initialize, méthode (shobjidl.h)

Article
03/02/2024

Initialise l’objet Assistant Publication avec les fichiers à transférer, les paramètres à utiliser et le type d’Assistant à créer.

Note Windows Vista ne prend plus en charge l’Assistant Impression en ligne. Toutefois, cette méthode peut toujours être utilisée pour générer l’Assistant Ajout d’un emplacement réseau.

Syntaxe

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

Paramètres

[in] pdo

Type : IDataObject*

Pointeur vers un instance d’IDataObject qui représente les fichiers ou le dossier à transférer, si pszServiceProvider est InternetPhotoPrinting. Si pszServiceProvider a la valeur AddNetPlace, ce paramètre a la valeur NULL.

[in] dwOptions

Type : DWORD

Combinaison des indicateurs suivants.

SHPWHF_NORECOMPRESS

N’autorisez pas la recompression des données d’image. À utiliser avec l’Assistant Impression en ligne.

SHPWHF_NONETPLACECREATE

Ne créez pas de raccourci d’emplacement réseau lorsque le transfert de données est terminé. Cet indicateur est destiné à être utilisé avec l’Assistant Ajout d’un emplacement réseau.

SHPWHF_NOFILESELECTOR

N’autorisez pas l’utilisateur à modifier la sélection de fichiers dans l’Assistant.

SHPWHF_USEMRU

Non pris en charge.

SHPWHF_ANYLOCATION

Windows Vista et versions ultérieures. À utiliser avec l’Assistant Ajout d’un emplacement réseau. Si cet indicateur est défini et que pszServiceProvider a la valeur AddNetPlace, l’Assistant Ajout d’un emplacement réseau affiche une option permettant de sélectionner un emplacement réseau autre que les emplacements ou fournisseurs inscrits pour apparaître dans l’Assistant.

SHPWHF_VALIDATEVIAWEBFOLDERS

À utiliser avec l’Assistant Ajout d’un emplacement réseau. Dans Windows XP, si cet indicateur est défini et qu’une tentative d’ouverture de l’emplacement réseau à l’aide de WebDAV échoue, l’Assistant Ajout d’un emplacement réseau tente de créer un dossier web pour l’emplacement, en utilisant la prise en charge de WEC. Dans Windows Vista et Windows Server 2003, cet indicateur n’a aucun effet et les emplacements réseau sans prise en charge de WebDAV peuvent ne pas être ouverts en tant que dossiers web.

[in] pszServiceScope

Type : LPCWSTR

Chaîne Unicode qui indique le type d’Assistant à afficher. Les valeurs suivantes respectant la casse sont prises en charge dans Windows Vista.

AddNetPlace

Initialisez l’Assistant Ajout d’un emplacement réseau.

InternetPhotoPrinting

Initialisez l’Assistant Impression en ligne. Non pris en charge dans Windows Vista.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ou une valeur d’erreur, y compris les éléments suivants :

Code de retour	Description
E_INVALIDARG	Dans Windows Vista, peut indiquer une tentative d’initialisation de l’Assistant Impression en ligne non pris en charge en passant `InternetPhotoPrinting`pszServiceProvider. Dans Windows XP, peut indiquer que lors de l’initialisation de l’Assistant Impression en ligne, le paramètre pdo est NULL ou pointe vers une sélection vide.
E_NOTIMPL	Le paramètre pszServiceProvider ne fait pas partie des valeurs prises en charge ou le paramètre dwOptions contient une combinaison d’indicateurs non prise en charge.

Remarques

IPublishingWizard ::Initialize, implémenté par un objet Assistant Publication , est appelé pour initialiser l’objet Assistant.

L’exemple suivant ne fonctionne pas sur Windows Vista, car l’Assistant Impression en ligne ne peut pas être instancié via IPublishingWizard dans 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 n’affiche pas réellement l’Assistant initialisé. Pour plus d’informations sur l’affichage de l’Assistant, consultez la rubrique IPublishingWizard .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl.h
DLL	Netplwiz.dll

Partager via