CAtlFileMappingBase::OpenMapping

Llame a este método para abrir un objeto de asignación de archivos con nombre para el archivo especificado.

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

Parámetros

• szName
  El nombre del objeto de asignación.Si hay un identificador abierto a un objeto de asignación de archivos por este nombre y el descriptor de seguridad en el objeto de asignación no entra en conflicto con el parámetro de dwViewDesiredAccess , la operación abierta correctamente.

• 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 del objeto de asignación de archivos identificado por szName.

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

• 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

En compilaciones de depuración, un error de aserción aparecerá si los parámetros de entrada son válidos.

Requisitos

encabezado: atlfile.h

Vea también

Referencia

Clase de CAtlFileMappingBase

CAtlFileMappingBase::MapFile