OpenFile, fonction (winbase.h)

Crée, ouvre, rouvre ou supprime un fichier.

Syntaxe

HFILE OpenFile(
  [in]  LPCSTR     lpFileName,
  [out] LPOFSTRUCT lpReOpenBuff,
  [in]  UINT       uStyle
);

Paramètres

[in] lpFileName

Nom du fichier.

La chaîne doit se composer de caractères du jeu de caractères Windows 8 bits. La fonction OpenFile ne prend pas en charge les noms de fichiers Unicode ni l’ouverture de canaux nommés.

[out] lpReOpenBuff

Pointeur vers la structure OFSTRUCT qui reçoit des informations sur un fichier lors de sa première ouverture.

La structure peut être utilisée dans les appels suivants à la fonction OpenFile pour afficher un fichier ouvert.

La structure OFSTRUCT contient un membre de chaîne de chemin d’accès dont la longueur est limitée à OFS_MAXPATHNAME caractères, soit 128 caractères. Pour cette raison, vous ne pouvez pas utiliser la fonction OpenFile pour ouvrir un fichier dont la longueur de chemin dépasse 128 caractères. La fonction CreateFile n’a pas cette limite de longueur de chemin.

[in] uStyle

Action à entreprendre.

Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur retournée

Si la fonction réussit, la valeur de retour spécifie un descripteur de fichier à utiliser lors de l’exécution d’E/S de fichier. Pour fermer le fichier, appelez la fonction CloseHandle à l’aide de ce handle.

Si la fonction échoue, la valeur de retour est HFILE_ERROR. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Si le paramètre lpFileName spécifie un nom de fichier et une extension uniquement, cette fonction recherche un fichier correspondant dans les répertoires suivants et dans l’ordre indiqué :

1. Répertoire dans lequel une application est chargée.
2. Le répertoire actif.
3. Répertoire système Windows.

   Utilisez la fonction GetSystemDirectory pour obtenir le chemin d’accès de ce répertoire.

4. Répertoire système Windows 16 bits.

   Il n’existe pas de fonction qui récupère le chemin d’accès de ce répertoire, mais elle fait l’objet d’une recherche.

5. Répertoire Windows.

   Utilisez la fonction GetWindowsDirectory pour obtenir le chemin d’accès de ce répertoire.

6. Répertoires répertoriés dans la variable d’environnement PATH.

La fonction OpenFile ne prend pas en charge l’indicateur OF_SEARCH pris en charge par la fonction Windows OpenFile 16 bits. L’indicateur OF_SEARCH indique au système de rechercher un fichier correspondant, même lorsqu’un nom de fichier inclut un chemin d’accès complet. Utilisez la fonction SearchPath pour rechercher un fichier.

Une violation de partage se produit si une tentative d’ouverture d’un fichier ou d’un répertoire est effectuée pour suppression sur un ordinateur distant lorsque la valeur du paramètre uStyle est l’indicateur d’accès OF_DELETE OR’ed avec tout autre indicateur d’accès, et que le fichier ou répertoire distant n’a pas été ouvert avec FILE_SHARE_DELETE partage d’accès . Pour éviter la violation de partage dans ce scénario, ouvrez le fichier ou le répertoire distant avec OF_DELETE accès uniquement, ou appelez DeleteFile sans ouvrir au préalable le fichier ou le répertoire pour suppression.

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

CsvFs effectue les E/S redirigées pour les fichiers compressés.

Configuration requise

Voir aussi

CreateFile

Fonctions de gestion des fichiers

GetSystemDirectory

GetWindowsDirectory

OFSTRUCT

SearchPath