Partilhar via


CAtlFileMappingBase::OpenMapping

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

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

Parâmetros

  • szName
    O nome do objeto de mapeamento.Se houver um identificador aberta a um objeto de mapeamento de arquivo por esse nome e o descritor de segurança no objeto de mapeamento não está em conflito com o parâmetro de dwViewDesiredAccess , a operação aberta êxito.

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

  • 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.

  • 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

Em compilações de depuração, um erro ocorrerá se asserção dos parâmetros de entrada são inválidos.

Requisitos

Cabeçalho: atlfile.h

Consulte também

Referência

Classe de CAtlFileMappingBase

CAtlFileMappingBase::MapFile