Table of Contents

Interface RegistryPrx

Namespace
IceGrid
Assembly
IceGrid.dll

Represents the main entry point into the IceGrid registry service. It provides operations to create sessions with the registry.

public interface RegistryPrx : ObjectPrx, IEquatable<ObjectPrx>
Inherited Members

Remarks

The Slice compiler generated this client-side interface from Slice interface ::IceGrid::Registry. Use the methods of this interface to invoke operations on a remote Ice object that implements Registry.

Methods

createAdminSession(string, string, Dictionary<string, string>?)

Creates an administrative session.

AdminSessionPrx? createAdminSession(string userId, string password, Dictionary<string, string>? context = null)

Parameters

userId string

The user ID.

password string

The password for the given user.

context Dictionary<string, string>

The request context.

Returns

AdminSessionPrx

A proxy to the newly created session. This proxy is never null.

Exceptions

PermissionDeniedException

Thrown when authentication or authorization fails.

createAdminSessionAsync(string, string, Dictionary<string, string>?, IProgress<bool>?, CancellationToken)

Creates an administrative session.

Task<AdminSessionPrx?> createAdminSessionAsync(string userId, string password, Dictionary<string, string>? context = null, IProgress<bool>? progress = null, CancellationToken cancel = default)

Parameters

userId string

The user ID.

password string

The password for the given user.

context Dictionary<string, string>

The request context.

progress IProgress<bool>

The sent progress provider.

cancel CancellationToken

A cancellation token that receives the cancellation requests.

Returns

Task<AdminSessionPrx>

A task that represents the asynchronous operation.

Exceptions

PermissionDeniedException

Thrown when authentication or authorization fails.

createAdminSessionFromSecureConnection(Dictionary<string, string>?)

Creates an administrative session from a secure connection.

AdminSessionPrx? createAdminSessionFromSecureConnection(Dictionary<string, string>? context = null)

Parameters

context Dictionary<string, string>

The request context.

Returns

AdminSessionPrx

A proxy to the newly created session. This proxy is never null.

Exceptions

PermissionDeniedException

Thrown when authentication or authorization fails.

createAdminSessionFromSecureConnectionAsync(Dictionary<string, string>?, IProgress<bool>?, CancellationToken)

Creates an administrative session from a secure connection.

Task<AdminSessionPrx?> createAdminSessionFromSecureConnectionAsync(Dictionary<string, string>? context = null, IProgress<bool>? progress = null, CancellationToken cancel = default)

Parameters

context Dictionary<string, string>

The request context.

progress IProgress<bool>

The sent progress provider.

cancel CancellationToken

A cancellation token that receives the cancellation requests.

Returns

Task<AdminSessionPrx>

A task that represents the asynchronous operation.

Exceptions

PermissionDeniedException

Thrown when authentication or authorization fails.

createSession(string, string, Dictionary<string, string>?)

Creates a client session.

SessionPrx? createSession(string userId, string password, Dictionary<string, string>? context = null)

Parameters

userId string

The user ID.

password string

The password for the given user.

context Dictionary<string, string>

The request context.

Returns

SessionPrx

A proxy to the newly created session. This proxy is never null.

Exceptions

PermissionDeniedException

Thrown when authentication or authorization fails.

createSessionAsync(string, string, Dictionary<string, string>?, IProgress<bool>?, CancellationToken)

Creates a client session.

Task<SessionPrx?> createSessionAsync(string userId, string password, Dictionary<string, string>? context = null, IProgress<bool>? progress = null, CancellationToken cancel = default)

Parameters

userId string

The user ID.

password string

The password for the given user.

context Dictionary<string, string>

The request context.

progress IProgress<bool>

The sent progress provider.

cancel CancellationToken

A cancellation token that receives the cancellation requests.

Returns

Task<SessionPrx>

A task that represents the asynchronous operation.

Exceptions

PermissionDeniedException

Thrown when authentication or authorization fails.

createSessionFromSecureConnection(Dictionary<string, string>?)

Creates a client session from a secure connection.

SessionPrx? createSessionFromSecureConnection(Dictionary<string, string>? context = null)

Parameters

context Dictionary<string, string>

The request context.

Returns

SessionPrx

A proxy to the newly created session. This proxy is never null.

Exceptions

PermissionDeniedException

Thrown when authentication or authorization fails.

createSessionFromSecureConnectionAsync(Dictionary<string, string>?, IProgress<bool>?, CancellationToken)

Creates a client session from a secure connection.

Task<SessionPrx?> createSessionFromSecureConnectionAsync(Dictionary<string, string>? context = null, IProgress<bool>? progress = null, CancellationToken cancel = default)

Parameters

context Dictionary<string, string>

The request context.

progress IProgress<bool>

The sent progress provider.

cancel CancellationToken

A cancellation token that receives the cancellation requests.

Returns

Task<SessionPrx>

A task that represents the asynchronous operation.

Exceptions

PermissionDeniedException

Thrown when authentication or authorization fails.

getSessionTimeout(Dictionary<string, string>?)

Gets the session timeout. An Ice 3.7 or earlier client can use this value to determine how often it needs to send heartbeats (using ACM) or call keepAlive(Dictionary<string, string>?) (resp. keepAlive(Dictionary<string, string>?)) to keep a session alive in the IceGrid registry.

[Obsolete]
int getSessionTimeout(Dictionary<string, string>? context = null)

Parameters

context Dictionary<string, string>

The request context.

Returns

int

The session timeout (in seconds).

getSessionTimeoutAsync(Dictionary<string, string>?, IProgress<bool>?, CancellationToken)

Gets the session timeout. An Ice 3.7 or earlier client can use this value to determine how often it needs to send heartbeats (using ACM) or call keepAlive(Dictionary<string, string>?) (resp. keepAlive(Dictionary<string, string>?)) to keep a session alive in the IceGrid registry.

[Obsolete]
Task<int> getSessionTimeoutAsync(Dictionary<string, string>? context = null, IProgress<bool>? progress = null, CancellationToken cancel = default)

Parameters

context Dictionary<string, string>

The request context.

progress IProgress<bool>

The sent progress provider.

cancel CancellationToken

A cancellation token that receives the cancellation requests.

Returns

Task<int>

A task that represents the asynchronous operation.