CAtlFileMappingBase::MapFile

Chame esse método para em em aberto 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 a partir do qual criar um objeto de mapeamento.hFile deve ser válido e não pode ser definido como INVALID_HANDLE_VALUE.

  • nMappingSize
    O dimensionar do mapeamento.Se for 0, o dimensionar máximo do objeto de mapeamento do arquivo é igual ao dimensionar corrente do arquivo identificado por hFile.

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

  • dwMappingProtection
    A proteção desejada para o modo de exibição do arquivo quando o arquivo está mapeado.See flProtect em CreateFileMapping in the Windows SDK.

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

Valor de retorno

RetornaS_OK no sucesso ou um erro HRESULT em caso de falha.

Comentários

Após ter sido criado um objeto de mapeamento de arquivo, o dimensionar do arquivo não deve exceder o dimensionar do objeto de mapeamento de arquivo; em caso afirmativo, nem todo o Sumário do arquivo será disponibilizado para compartilhamento.Para obter mais detalhes, consulte CreateFileMapping and MapViewOfFileEx in the Windows SDK.

Exemplo

Consulte o exemplo para CAtlFileMappingBase::CAtlFileMappingBase.

Anotações Developer Dispositivo Inteligente

O parâmetro hFile deve ser um identificador retornado da CreateFileForMapping e não pode ser um identificador retornado de CreateFile.Essa restrição também significa que esse método não pode ser usado em conjunto com AtlFile.

Requisitos

Cabeçalho: atlfile.h

Consulte também

Referência

Classe CAtlFileMappingBase

Outros recursos

CAtlFileMappingBase membros

  • Last updated on