Funzione OpenFileMappingFromApp (memoryapi.h)

  • Articolo

Apre un oggetto di mapping di file denominato.

Sintassi

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

Parametri

[in] DesiredAccess

Accesso all'oggetto mapping di file. Questo accesso viene controllato su qualsiasi descrittore di sicurezza nell'oggetto mapping dei file di destinazione. Per un elenco di valori, vedere Sicurezza mapping file e diritti di accesso. È possibile aprire l'oggetto di mapping dei file solo per l'accesso FILE_MAP_EXECUTE se l'app ha la funzionalità codeGeneration .

[in] InheritHandle

Se questo parametro è TRUE, un processo creato dalla funzione CreateProcess può ereditare l'handle; in caso contrario, l'handle non può essere ereditato.

[in] Name

Nome dell'oggetto di mapping dei file da aprire. Se è presente un handle aperto a un oggetto mapping di file in base a questo nome e il descrittore di sicurezza nell'oggetto mapping non è in conflitto con il parametro DesiredAccess , l'operazione di apertura ha esito positivo. Il nome può avere un prefisso "Global" o "Local" per aprire in modo esplicito un oggetto nello spazio dei nomi globale o sessione. Il resto del nome può contenere qualsiasi carattere, ad eccezione del carattere barra rovesciata (\). Per altre informazioni, vedere Spazi dei nomi degli oggetti kernel. Il passaggio rapido degli utenti viene implementato usando le sessioni di Servizi terminal. Il primo utente a eseguire l'accesso usa la sessione 0, l'utente successivo per accedere usa la sessione 1 e così via. I nomi degli oggetti kernel devono seguire le linee guida descritte per Servizi terminal in modo che le applicazioni possano supportare più utenti.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle aperto per l'oggetto mapping di file specificato.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

È possibile chiamare OpenFileMappingFromApp dalle app di Windows Store con funzionalità JIT (JUST-In-Time) per usare la funzionalità JIT. L'app deve includere la funzionalità codeGeneration nel file manifesto dell'app per usare le funzionalità JIT. OpenFileMappingFromApp consente alle app di Windows Store di usare la classe MemoryMappedFile in .NET Framework.

L'handle restituito da OpenFileMappingFromApp può essere usato con qualsiasi funzione che richiede un handle a un oggetto mapping di file.

Quando si modifica un file tramite una visualizzazione mappata, l'ultimo timestamp di modifica potrebbe non essere aggiornato automaticamente. Se necessario, il chiamante deve usare SetFileTime per impostare il timestamp.

Quando non è più necessario, il chiamante deve chiamare il gestore restituito da OpenFileMappingFromApp con una chiamata a CloseHandle.

Requisiti

   
Client minimo supportato Windows 10 [app desktop | App UWP]
Server minimo supportato Windows Server 2016 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione memoryapi.h (include Windows.h)
Libreria WindowsApp.lib
DLL Kernel32.dll

Vedere anche

CreateFileMapping

Funzioni di mapping dei file

Funzioni di gestione della memoria

OpenFileMapping

Condivisione di file e memoria