Partilhar via


CAtlFileMappingBase::OpenMapping

telefonar Esse método para em aberto um objeto de mapeamento do arquivo nomeado 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 em aberto para um objeto de mapeamento de arquivo, esse nome e o descritor de segurança no objeto de mapeamento não está em conflito com o dwViewDesiredAccess parâmetro, a operação de abertura é bem-sucedida.

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

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

  • 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

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

Requisitos

Cabeçalho: atlfile.h

Consulte também

Referência

Classe CAtlFileMappingBase

CAtlFileMappingBase::MapFile

Outros recursos

CAtlFileMappingBase membros