Partilhar via


CAtlFileMappingBase::MapFile

Chamar esse método para abrir ou criar um objeto de mapeamento de arquivo para o arquivo especificado.

HRESULT MapFile(
   HANDLE hFile,
   SIZE_T nMappingSize = 0,
   ULONGLONG nOffset = 0,
   DWORD dwMappingProtection = PAGE_READONLY,
   DWORD dwViewDesiredAccess = FILE_MAP_READ 
) throw( );

Parâmetros

  • hFile
    Identificador para o arquivo que para criar um mapeamento objeto.hFile deve ser válido e não pode ser definido INVALID_HANDLE_VALUE.

  • nMappingSize
    o tamanho de mapeamento.Se 0, o tamanho máximo do objeto de mapeamento de arquivo são igual ao tamanho atual do arquivo identificado por hFile.

  • nOffset
    O arquivo desloca onde o mapeamento é iniciar.O valor de deslocamento deve ser um múltiplas de granularidade de alocação de memória do sistema.

  • dwMappingProtection
    Proteção quiser a exibição do arquivo quando o arquivo é mapeado.Consulte flProtect em CreateFileMapping em Windows SDK.

  • dwViewDesiredAccess
    Especifica o tipo de acesso para o modo de arquivo e, portanto, a proteção das páginas mapeadas por arquivo.Consulte dwDesiredAccess em MapViewOfFileEx em Windows SDK.

Valor de retorno

Retorna S_OK em êxito, ou um erro HRESULT em caso de falha.

Comentários

Depois que um objeto de mapeamento de arquivo foi criado, o tamanho do arquivo não deve exceder o tamanho do objeto de mapeamento de arquivo; se fizer isso, o conteúdo de qualquer arquivo não estarão disponíveis para compartilhar.Para mais detalhes, consulte CreateFileMapping e MapViewOfFileEx em Windows SDK.

Exemplo

Consulte o exemplo para CAtlFileMappingBase::CAtlFileMappingBase.

Requisitos

Cabeçalho: atlfile.h

Consulte também

Referência

Classe de CAtlFileMappingBase