OpenFileMappingFromApp-Funktion (memoryapi.h)

Öffnet ein benanntes Dateizuordnungsobjekt.

Syntax

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

Parameter

[in] DesiredAccess

Der Zugriff auf das Dateizuordnungsobjekt. Dieser Zugriff wird mit jedem Sicherheitsdeskriptor für das Zieldateizuordnungsobjekt überprüft. Eine Liste der Werte finden Sie unter Dateizuordnungssicherheit und -zugriffsrechte. Sie können das Dateizuordnungsobjekt nur für FILE_MAP_EXECUTE Zugriff öffnen, wenn Ihre App über die codeGeneration-Funktion verfügt.

[in] InheritHandle

Wenn dieser Parameter TRUE ist, kann ein prozess, der von der CreateProcess-Funktion erstellt wurde, das Handle erben. Andernfalls kann das Handle nicht geerbt werden.

[in] Name

Der Name des zu öffnenden Dateizuordnungsobjekts. Wenn ein geöffnetes Handle für ein Dateizuordnungsobjekt mit diesem Namen vorhanden ist und der Sicherheitsdeskriptor des Zuordnungsobjekts nicht mit dem DesiredAccess-Parameter in Konflikt steht, ist der Öffnenvorgang erfolgreich. Der Name kann ein Präfix "Global" oder "Local" aufweisen, um ein Objekt explizit im globalen Namespace oder im Sitzungsnamespace zu öffnen. Der Rest des Namens kann ein beliebiges Zeichen mit Ausnahme des umgekehrten Schrägstrichs (\) enthalten. Weitere Informationen finden Sie unter Kernelobjektnamespaces. Der schnelle Benutzerwechsel wird mithilfe von Terminaldienstesitzungen implementiert. Der erste Benutzer, der sich anmeldet, verwendet Sitzung 0, der nächste Benutzer, der sich anmeldet, Sitzung 1 usw. Kernelobjektnamen müssen den Richtlinien für Terminaldienste entsprechen, damit Anwendungen mehrere Benutzer unterstützen können.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein geöffnetes Handle für das angegebene Dateizuordnungsobjekt.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Sie können OpenFileMappingFromApp aus Windows Store-Apps mit JIT-Funktionen (Just-in-Time) aufrufen, um JIT-Funktionen zu verwenden. Die App muss die codeGeneration-Funktion in der App-Manifestdatei enthalten, um JIT-Funktionen verwenden zu können. Mit OpenFileMappingFromApp können Windows Store-Apps die MemoryMappedFile-Klasse im .NET Framework verwenden.

Das Von OpenFileMappingFromApp zurückgegebene Handle kann mit jeder Funktion verwendet werden, die ein Handle für ein Dateizuordnungsobjekt erfordert.

Wenn Sie eine Datei über eine zugeordnete Ansicht ändern, wird der Zeitstempel der letzten Änderung möglicherweise nicht automatisch aktualisiert. Bei Bedarf sollte der Aufrufer SetFileTime verwenden, um den Zeitstempel festzulegen.

Wenn es nicht mehr benötigt wird, sollte der Aufrufer das von OpenFileMappingFromApp zurückgegebene Handle mit einem Aufruf von CloseHandle aufrufen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 10 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	memoryapi.h (windows.h einschließen)
Bibliothek	WindowsApp.lib
DLL	Kernel32.dll

Siehe auch

CreateFileMapping

Dateizuordnungsfunktionen

Speicherverwaltungsfunktionen

OpenFileMapping

Freigeben von Dateien und Arbeitsspeicher