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

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

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 :

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