IMR_IDEROpenTCPSessionEx

SDK Resources > Redirection Library > Redirection Library API > Functions for Handling Storage Redirection > IMR_IDEROpenTCPSessionEx

IMR_IDEROpenTCPSessionEx

note-icon Note:

When working in Linux, Redirection is supported with physical disks only. There is no Linux Redirection support for iso or img files.

This function opens a Storage Redirection session with the specified client over a new TCP connection. If the client uses secure communications, a TLS session will be negotiated with it. The function optionally defines a proxy connection with an MPS. The function returns only when the session is established or if an error has occurred. If the credentials are not NULL and there is no corresponding ACL entry, the connection attempt will fail. If the credential parameters are NULL, the library will attempt to connect with the Active Directory credentials of the application user. If the params structure is based on TCPSessionParamsEx2, the credentials are explicit Active Directory credentials that can include a domain name. After the session is open the client can initiate data transfers.

note-icon Note:

In Releases 4.2 through 6.2 if an SOL/IDE-R session fails to open, retry to open the session.

Function Header

IMRResult IMR_IDEROpenTCPSession(

ClientID id,

TCPSessionParamsEx *params or TCPSessionParamsEx2 *params,

IDERTouts *touts,

char *drive0,

char *drive1

);

Function Parameters

Field	Input/Output	Value or Description
id	Input	The ID of the relevant client.
params	Input	A pointer to a struct with session parameters. This parameter must not be NULL. When the structure is based on TCPSessionParamsEx, the connection is established using explicit Digest credentials or implicit Active Directory credentials. When the structure is based on TCPSessionParamsEx2, the connection is established using explicit Active Directory credentials (Windows username and password).
touts	Input	A pointer to a struct with timeout parameters. This parameter may be NULL, in which case the default values of the parameters will be used. See the struct definition for the default values.
drive0	Input	A pointer to a NULL-terminated string holding the name of the floppy disk drive on the Management Console platform that will be used for storage redirection (e.g. “A:”). For the Windows dynamic library, the string can also hold the path to a binary floppy image file (recommended, see Performance). This parameter must not be NULL.
drive1	Input	A pointer to a NULL-terminated string holding the name of the CD or DVD (Windows only) drive on the Management Console platform that will be used for storage redirection (e.g. “E:”). For the Windows dynamic library, the string can also hold a path to an ISO CD/DVD image file. This parameter must not be NULL.

Function Return Status

For a complete list of possible error codes, see Error Codes.

Status	Value or Description
IMR_RES_OK	The command finished successfully.
IMR_RES_SESSION_ALREADY_OPEN	A Storage Redirection session is already open with the specified client.
IMR_RES_CLIENT_BUSY	The specified client already has an open Storage Redirection session with another application.
IMR_RES_USER_CONSENT_REQUIRED	Command cannot complete until user consent sequence completes.