Partager via


IInitializeWithFile ::Initialize, méthode (propsys.h)

Initialise un gestionnaire avec un chemin d’accès de fichier.

Syntaxe

HRESULT Initialize(
  [in] LPCWSTR pszFilePath,
  [in] DWORD   grfMode
);

Paramètres

[in] pszFilePath

Type : LPCWSTR

Pointeur vers une mémoire tampon qui contient le chemin du fichier sous la forme d’une chaîne Unicode terminée par null.

[in] grfMode

Type : DWORD

Une des valeurs STGM suivantes qui indique le mode d’accès pour pszFilePath.

STGM_READ

Le fichier indiqué par IInitializeWithFile ::Initialize est en lecture seule.

STGM_READWRITE

Le fichier indiqué par IInitializeWithFile ::Initialize peut être lu et écrit dans.

Valeur retournée

Type : HRESULT

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

Remarques

Initialize est préféré à cette méthode en raison de sa capacité à utiliser des fichiers qui ne sont pas accessibles via un chemin Win32, tels que le contenu d’un fichier compressé avec une extension de nom de fichier .zip. Utilisez IInitializeWithFile ::Initialize uniquement lorsque l’API utilisée par le gestionnaire pour accéder au fichier accepte uniquement les chemins d’accès aux fichiers.

Le fichier pointé par pszFilePath doit rester ouvert pendant toute la durée de vie du gestionnaire ou jusqu’à ce que IPropertyStore ::Commit soit appelé.

Si le fichier ne peut pas être ouvert en fonction des valeurs de paramètre de la méthode, 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 doivent entraîner 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 propsys.h