CAtlFileMappingBase::MapFile

Llame a este método para abrir o crear un objeto de asignación de archivos para el archivo 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 del archivo del que se crea un objeto de asignación.hFile debe ser válido y no se puede establecer en INVALID_HANDLE_VALUE.

• nMappingSize
  El tamaño de asignación.Si 0, el tamaño máximo del objeto de asignación de archivos es igual al tamaño actual de archivo identificado por hFile.

• nOffset
  El desplazamiento de archivo donde debe comenzar la asignación.El valor de desplazamiento debe ser un múltiplo de la granularidad de asignación de memoria del sistema.

• dwMappingProtection
  Protección deseado para la vista del archivo cuando se asigna el archivo.Vea flProtect en CreateFileMapping en Windows SDK.

• dwViewDesiredAccess
  Especifica el tipo de acceso a la vista del archivo y, por consiguiente, la protección de las páginas asignadas por el archivo.Vea dwDesiredAccess en MapViewOfFileEx en Windows SDK.

Valor devuelto

Devuelve S_OK en correctamente, o un error HRESULT en el error.

Comentarios

Una vez creado un objeto de asignación de archivos, el tamaño del archivo no debe superar el tamaño del objeto de asignación de archivos; si lo hace, el contenido de no todo el archivo estarán disponibles para compartir.Para obtener más detalles, vea CreateFileMapping y MapViewOfFileEx en Windows SDK.

Ejemplo

Vea el ejemplo para CAtlFileMappingBase:: CAtlFileMappingBase.

Requisitos

encabezado: atlfile.h

Vea también

Referencia

Clase de CAtlFileMappingBase