Metodo ITransferSource::OpenItem (shobjidl_core.h)

Apre l'elemento per la copia. Restituisce un oggetto che può essere enumerato per le risorse (IShellItemResources).

Sintassi

HRESULT OpenItem(
  [in]  IShellItem            *psi,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] REFIID                riid,
  [out] void                  **ppv
);

Parametri

[in] psi

Tipo: IShellItem*

Puntatore a IShellItem da aprire.

[in] flags

Tipo: TRANSFER_SOURCE_FLAGS

Flag che controllano l'operazione di file. Una o più costanti TRANSFER_SOURCE_FLAGS .

[out] riid

Tipo: REFIID

Riferimento all'IID (ID interfaccia o GUID) dell'interfaccia da restituire in ppv. Deve trattarsi di un'interfaccia IShellItemResources o di un'interfaccia derivata da IShellItemResources.

[out] ppv

Tipo: void**

Quando questo metodo restituisce, contiene l'indirizzo di un puntatore all'interfaccia specificata da riid.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o uno dei codici di shell specifici seguenti o un codice di errore di sistema.

Codice restituito	Descrizione
COPYENGINE_S_YES	L'utente ha risposto "Sì" alla finestra di dialogo.
COPYENGINE_S_USER_RETRY	L'utente ha risposto per ripetere l'azione corrente.
COPYENGINE_S_USER_IGNORED	L'utente ha risposto "No" alla finestra di dialogo.
COPYENGINE_S_MERGE	L'utente ha risposto alle cartelle di tipo merge.
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME	L'utente ha risposto per riprovare il file con nuovo nome.
COPYENGINE_S_DONT_PROCESS_CHILDREN	Gli elementi figlio non devono essere elaborati.
COPYENGINE_S_PENDING	L'errore è stato accodato e verrà visualizzato in un secondo momento.
COPYENGINE_E_USER_CANCELLED	L'utente ha annullato l'azione corrente.
COPYENGINE_E_REQUIRES_ELEVATION	L'operazione richiede privilegi elevati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)