Méthode ITransferSource ::OpenItem (shobjidl_core.h)

  • Article

Ouvre l’élément pour la copie. Renvoie un objet qui peut être énuméré pour les ressources (IShellItemResources).

Syntaxe

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

Paramètres

[in] psi

Type : IShellItem*

Pointeur vers l’objet IShellItem à ouvrir.

[in] flags

Type : TRANSFER_SOURCE_FLAGS

Indicateurs qui contrôlent l’opération de fichier. Une ou plusieurs constantes TRANSFER_SOURCE_FLAGS .

[out] riid

Type : REFIID

Référence à l’IID (ID d’interface ou GUID) de l’interface à retourner dans ppv. Il doit s’agir d’un IShellItemResources ou d’une interface dérivée de IShellItemResources.

[out] ppv

Type : void**

Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers l’interface spécifiée par riid.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou l’un des codes Shell spécifiques suivants ou un code d’erreur système.

Code de retour Description
COPYENGINE_S_YES
 L’utilisateur a répondu « Oui » à la boîte de dialogue.
COPYENGINE_S_USER_RETRY
 L’utilisateur a répondu pour réessayer l’action actuelle.
COPYENGINE_S_USER_IGNORED
 L’utilisateur a répondu « Non » à la boîte de dialogue.
COPYENGINE_S_MERGE
 L’utilisateur a répondu aux dossiers de fusion.
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME
 L’utilisateur a répondu pour réessayer le fichier avec un nouveau nom.
COPYENGINE_S_DONT_PROCESS_CHILDREN
 Les éléments enfants ne doivent pas être traités.
COPYENGINE_S_PENDING
 L’erreur a été mise en file d’attente et s’affichera ultérieurement.
COPYENGINE_E_USER_CANCELLED
 L’utilisateur a annulé l’action en cours.
COPYENGINE_E_REQUIRES_ELEVATION
 L’opération nécessite des privilèges élevés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (inclure Shobjidl.h)