CreateFile2FromAppW, fonction (fileapifromapp.h)

Crée ou ouvre un fichier ou un appareil d’E/S. Le comportement de cette fonction est identique à CreateFile2, sauf que cette fonction respecte le modèle de sécurité des applications de plateforme Windows universelle.

Syntaxe

WINSTORAGEAPI HANDLE CreateFile2FromAppW(
  LPCWSTR                           lpFileName,
  DWORD                             dwDesiredAccess,
  DWORD                             dwShareMode,
  DWORD                             dwCreationDisposition,
  LPCREATEFILE2_EXTENDED_PARAMETERS pCreateExParams
) noexcept;

Paramètres

lpFileName

Nom du fichier ou de l’appareil à créer ou ouvrir.

Pour plus d’informations sur les noms d’appareils spéciaux, consultez Définition d’un nom d’appareil MS-DOS.

Pour créer un flux de fichiers, spécifiez le nom du fichier, un signe deux-points, puis le nom du flux. Pour plus d’informations, consultez Flux de fichiers.

Pour plus d’informations sur la désactivation de la limitation de MAX_PATH sans précéder « \\ ?\ », consultez la section « Limite maximale de longueur du chemin d’accès » de Naming Files, Path et Namespaces pour plus d’informations.

dwDesiredAccess

Accès demandé au fichier ou à l’appareil, qui peut être résumé sous forme de lecture, d’écriture, à la fois ou de zéro).

Les valeurs les plus couramment utilisées sont GENERIC_READ, GENERIC_WRITE ou les deux (GENERIC_READ | GENERIC_WRITE). Pour plus d’informations, consultez Droits d’accès génériques, Sécurité des fichiers et droits d’accès, constantes des droits d’accès aux fichiers et ACCESS_MASK.

Si ce paramètre est égal à zéro, l’application peut interroger certaines métadonnées telles que des attributs de fichier, de répertoire ou d’appareil sans accéder à ce fichier ou appareil, même si GENERIC_READ’accès aurait été refusé.

Vous ne pouvez pas demander un mode d’accès qui est en conflit avec le mode de partage spécifié par le paramètre dwShareMode dans une demande ouverte qui a déjà un handle ouvert.

dwShareMode

Mode de partage demandé du fichier ou de l’appareil, qui peut être lu, écrit, à la fois, supprimer, tous ces éléments ou aucun (reportez-vous au tableau suivant). Les demandes d’accès aux attributs ou aux attributs étendus ne sont pas affectées par cet indicateur.

Si ce paramètre est égal à zéro et que la fonction réussit, le fichier ou l’appareil ne peut pas être partagé et ne peut pas être rouvert tant que le handle du fichier ou de l’appareil n’est pas fermé. Pour plus d’informations, consultez la section Remarques.

Vous ne pouvez pas demander un mode de partage qui est en conflit avec le mode d’accès spécifié dans une requête existante qui a un handle ouvert. Cette fonction échoue et la fonction GetLastError retourne ERROR_SHARING_VIOLATION.

Pour permettre à un processus de partager un fichier ou un appareil pendant qu’un autre processus a ouvert le fichier ou l’appareil, utilisez une combinaison compatible d’une ou plusieurs des valeurs suivantes. Pour plus d’informations sur les combinaisons valides de ce paramètre avec le paramètre dwDesiredAccess , consultez Création et ouverture de fichiers.

Note Les options de partage pour chaque handle ouvert restent en vigueur jusqu’à ce que ce handle soit fermé, quel que soit le contexte du processus.

dwCreationDisposition

Action à entreprendre sur un fichier ou un appareil qui existe ou n’existe pas.

Pour les appareils autres que les fichiers, ce paramètre est généralement défini sur OPEN_EXISTING.

Ce paramètre doit être l’une des valeurs suivantes, qui ne peuvent pas être combinées :

pCreateExParams

Pointeur vers une structure CREATEFILE2_EXTENDED_PARAMETERS facultative.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle ouvert pour le fichier, l’appareil, le canal nommé ou l’emplacement de messagerie spécifié.

Si la fonction échoue, la valeur de retour est INVALID_HANDLE_VALUE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Spécifications