Metodo IPublishingWizard::Initialize (shobjidl.h)

Inizializza l'oggetto Pubblicazione guidata con i file da trasferire, le impostazioni da usare e il tipo di procedura guidata da creare.

Sintassi

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

Parametri

[in] pdo

Tipo: IDataObject*

Puntatore a un'istanza di IDataObject che rappresenta i file o la cartella da trasferire, se pszServiceProvider è InternetPhotoPrinting. Se pszServiceProvider è , questo parametro è AddNetPlaceNULL.

[in] dwOptions

Tipo: DWORD

Combinazione dei flag seguenti.

SHPWHF_NORECOMPRESS

Non consentire la ricompressione dei dati dell'immagine. Per l'uso con la Stampa guidata online.

SHPWHF_NONETPLACECREATE

Non creare un collegamento alla posizione di rete al termine del trasferimento dei dati. Questo flag è usato con l'Aggiunta guidata posizione rete.

SHPWHF_NOFILESELECTOR

Non consentire all'utente di modificare la selezione del file all'interno della procedura guidata.

SHPWHF_USEMRU

Non supportato.

SHPWHF_ANYLOCATION

Windows Vista e versioni successive. Per l'uso con l'Aggiunta guidata posizione rete. Se questo flag è impostato e pszServiceProvider è AddNetPlace, la procedura guidata Aggiungi posizione di rete mostra un'opzione per selezionare una posizione di rete diversa dalle posizioni o dai provider registrati nella procedura guidata.

SHPWHF_VALIDATEVIAWEBFOLDERS

Per l'uso con l'Aggiunta guidata posizione rete. In Windows XP, se questo flag è impostato e un tentativo di aprire il percorso di rete con WebDAV non riesce, la Procedura guidata Aggiungi posizione rete tenta di creare una cartella Web per il percorso, usando il supporto per WEC. In Windows Vista e Windows Server 2003 questo flag non ha alcun effetto e percorsi di rete senza supporto per WebDAV potrebbe non essere aperto come cartelle Web.

[in] pszServiceScope

Tipo: LPCWSTR

Stringa Unicode che indica il tipo di procedura guidata da visualizzare. I valori di distinzione tra maiuscole e minuscole seguenti sono supportati in Windows Vista.

AddNetPlace

Inizializzare l'Aggiunta guidata posizione rete.

InternetPhotoPrinting

Inizializzare la Creazione guidata stampa online. Non supportato in Windows Vista.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario, incluso quanto segue:

Commenti

IPublishingWizard::Initialize, implementato da un oggetto Pubblicazione guidata , viene chiamato per inizializzare l'oggetto procedura guidata.

L'esempio seguente non funziona in Windows Vista perché non è possibile creare un'istanza della Creazione guidata stampa online tramite IPublishingWizard in 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 non visualizza effettivamente la procedura guidata inizializzata. Per informazioni su come visualizzare la procedura guidata, vedere l'argomento IPublishingWizard .

Requisiti