IInitializeWithItem ::Initialize, méthode (shobjidl_core.h)

Article
03/04/2024

Initialise un gestionnaire avec un IShellItem.

Syntaxe

HRESULT Initialize(
  [in] IShellItem *psi,
  [in] DWORD      grfMode
);

Paramètres

[in] psi

Type : IShellItem*

Pointeur vers un IShellItem.

[in] grfMode

Type : DWORD

L’une des valeurs STGM suivantes qui indiquent le mode d’accès pour psi.

STGM_READ

IShellItem est en lecture seule.

STGM_READWRITE

L’IShellItem est accessible en lecture/écriture.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si l’objet IShellItem n’est pas accessible, cette méthode retourne un code d’erreur approprié.

Un gestionnaire instance ne doit être initialisé qu’une seule fois dans sa durée de vie. Les tentatives de réinitialisation du gestionnaire par l’application appelante entraînent l’erreur HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED).

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 (include Propsys.h)

Partager via