Fonction OpenFileMappingFromApp (memoryapi.h)

Ouvre un objet de mappage de fichiers nommé.

Syntaxe

HANDLE OpenFileMappingFromApp(
  [in] ULONG  DesiredAccess,
  [in] BOOL   InheritHandle,
  [in] PCWSTR Name
);

Paramètres

[in] DesiredAccess

Accès à l’objet de mappage de fichiers. Cet accès est vérifié par rapport à n’importe quel descripteur de sécurité sur l’objet de mappage de fichiers cibles. Pour obtenir la liste des valeurs, consultez Sécurité et droits d’accès du mappage de fichiers. Vous ne pouvez ouvrir l’objet de mappage de fichiers pour FILE_MAP_EXECUTE accès que si votre application dispose de la fonctionnalité codeGeneration .

[in] InheritHandle

Si ce paramètre a la valeur TRUE, un processus créé par la fonction CreateProcess peut hériter du handle ; sinon, le handle ne peut pas être hérité.

[in] Name

Nom de l’objet de mappage de fichiers à ouvrir. S’il existe un handle ouvert pour un objet de mappage de fichiers de ce nom et que le descripteur de sécurité de l’objet de mappage n’est pas en conflit avec le paramètre DesiredAccess , l’opération d’ouverture réussit. Le nom peut avoir un préfixe « Global » ou « Local » pour ouvrir explicitement un objet dans l’espace de noms global ou de session. Le reste du nom peut contenir n’importe quel caractère à l’exception du caractère barre oblique inverse (\). Pour plus d’informations, consultez Espaces de noms d’objets de noyau. Le changement rapide d’utilisateur est implémenté à l’aide de sessions Terminal Services. Le premier utilisateur à se connecter utilise la session 0, l’utilisateur suivant pour se connecter utilise la session 1, et ainsi de suite. Les noms d’objets de noyau doivent suivre les instructions décrites pour les services Terminal Server afin que les applications puissent prendre en charge plusieurs utilisateurs.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle ouvert à l’objet de mappage de fichiers spécifié.

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

Notes

Vous pouvez appeler OpenFileMappingFromApp à partir d’applications du Windows Store avec des fonctionnalités juste-à-temps (JIT) pour utiliser la fonctionnalité JIT. L’application doit inclure la fonctionnalité codeGeneration dans le fichier manifeste de l’application pour utiliser les fonctionnalités JIT. OpenFileMappingFromApp permet aux applications du Windows Store d’utiliser la classe MemoryMappedFile dans .NET Framework.

Le handle retourné par OpenFileMappingFromApp peut être utilisé avec n’importe quelle fonction qui nécessite un handle vers un objet de mappage de fichiers.

Lors de la modification d’un fichier via une vue mappée, l’horodatage de la dernière modification peut ne pas être mis à jour automatiquement. Si nécessaire, l’appelant doit utiliser SetFileTime pour définir l’horodatage.

Lorsqu’il n’est plus nécessaire, l’appelant doit appeler libérer le handle retourné par OpenFileMappingFromApp avec un appel à CloseHandle.

Spécifications

Voir aussi

CreateFileMapping

Fonctions de mappage de fichiers

Fonctions de gestion de la mémoire

OpenFileMapping

Partage de fichiers et de mémoire