MICreateSession() function - MapBasic - 2023

MapInfo MapBasic Reference

Product type
Software
Portfolio
Locate
Product family
MapInfo
Product
MapInfo > MapBasic
Version
2023
Language
English
Product name
MapBasic
Title
MapInfo MapBasic Reference
First publish date
1985
Last updated
2023-09-12
Published on
2023-09-12T16:32:32.686312

Purpose

Creates a CInternetSession object and returns the handle to it.

Syntax

MICreateSession( ByVal strAgent As String ) As CInternetSession

strAgent is a string that identifies the name of the application or entity calling the Internet functions (for example, "MapInfo Pro"). If the string is empty, the application name will be used.

Return Value

A handle to a CInternetSession object. If the call fails, Null is returned. To determine the cause of the failure, call the MIGetErrorMessage() function.

Description

MICreateSession() is the first Internet function called by an application. Use CInternetSession to create and initialize a single, or several simultaneous Internet sessions, and, if necessary, to describe your connection to a proxy server. If you want to perform service-specific (for example, HTTP, FTP) actions on files located on a server, you must establish the appropriate connection with that server. To open a particular kind of connection directly to a particular service, use the proper functions, such as the MIGetHttpConnection() function or the MIGetFtpConnection() function. For detailed information, refer to the Microsoft MSDN library.

The caller has to dispose of the handle by calling the MICloseSession() procedure when the handle is no longer in use.