Udostępnij za pośrednictwem


CAtlFileMappingBase::OpenMapping

Wywołanie tej metody, aby otworzyć nazwanego obiektu mapowania pliku do określonego pliku.

HRESULT OpenMapping(
   LPCTSTR szName,
   SIZE_T nMappingSize,
   ULONGLONG nOffset = 0,
   DWORD dwViewDesiredAccess = FILE_MAP_ALL_ACCESS 
) throw( );

Parametry

  • szName
    Nazwa obiektu mapowania.Jeśli nie ma otwarte dojście do obiektu mapowania pliku o tej nazwie i deskryptora zabezpieczeń obiektu mapowania nie powoduje konfliktu z dwViewDesiredAccess parametr, otwórz operacja powiedzie się.

  • nMappingSize
    Rozmiar mapowania.Jeśli 0, maksymalny rozmiar obiektu mapowania pliku jest równy rozmiarowi bieżącego obiektu mapowania pliku, identyfikowane przezszName.

  • nOffset
    Przesunięcie pliku, gdzie ma rozpocząć mapowanie.Wartość przesunięcia musi być wielokrotnością ziarnistość alokacji pamięci systemowej.

  • dwViewDesiredAccess
    Określa typ dostępu do widoku pliku, a zatem ochrony strony mapowane przez plik.Zobacz dwDesiredAccess w MapViewOfFileEx w Windows SDK.

Wartość zwracana

Zwraca S_OK o powodzeniu lub błędzie HRESULT w przypadku awarii.

Uwagi

W kompilacjach debugowania potwierdzenia wystąpi błąd, jeśli parametry wejściowe są nieprawidłowe.

Wymagania

Nagłówek: atlfile.h

Zobacz też

Informacje

Klasa CAtlFileMappingBase

CAtlFileMappingBase::MapFile