IMapControlDefault.ReadMxMaps Method

Opens a map document specified by the supplied filename and reads the maps into an array object.

[Visual Basic .NET]
Public Function ReadMxMaps ( _
    ByVal fileName As String, _
    [ByVal password As Object] _
) As IArray

[C#]
public IArray ReadMxMaps (
    string fileName,
    object password
);

[C++]
HRESULT ReadMxMaps(
  BSTR fileName,
  VARIANT password,
  IArray** pArray
);

[C++]
Parameters
fileName [in]
  fileName is a parameter of type BSTR
password [optional]
  password is a parameter of type VARIANT
  To indicate this parameter is undefined pass in a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.
pArray [out, retval]
  pArray is a parameter of type IArray

Product Availability

Description

ReadMxMaps creates an array of Map objects from the specified Map Document (ArcMap document, ArcMap template or ArcReader document).

Errors Returned

1018 800A03FA: The specified filename is invalid, the contents are corrupt or invalid

1019 800A03FB: The specified filename cannot be found 

1020 800A03FC: The specified filename is invalid, the file cannot be opened 

1021 800A03FD: The specified document has timed out

1031 800A0407: Password required to read this map document 

1032 800A0408: The specified password is incorrect

1033 800A0409: The password parameter does not contain a valid string 

Remarks

When ReadMXMaps is used the user may be prompted for a password; refer to the tables below to determine when this may occur. Additionally, password prompts may be given if accessing MapDocuments using either the MapControl's PropertyPage, ArcMap or ArcReader; the tables also show in what circumstances this will occur.

Reading Map Documents (*.mxd, *.mxt, *.pmf) which reference IMS Services (with and without security)

* The Connection to the Internet server must have the Save User/ Password setting enabled. This can be set, for example, when using Add Internet Server in the Add Layers Dialog. Additionally, in the case of PMF files the ArcPublisher Cache password in PMF file setting must be enabled.

Reading Published Map Files (*.pmf) (with and without password protection)

See Also

IMapControlDefault Interface | IMapControl3.CheckMxFile Method | IMapControlDefault.CheckMxFile Method | IMapControl4.CheckMxFile Method | IMapControl3.LoadMxFile Method | IMapControlDefault.LoadMxFile Method | IMapControl4.LoadMxFile Method