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
stringThe user ID.
password
stringThe 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
stringThe user ID.
password
stringThe password for the given user.
context
Dictionary<string, string>The request context.
progress
IProgress<bool>The sent progress provider.
cancel
CancellationTokenA 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
CancellationTokenA 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
stringThe user ID.
password
stringThe 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
stringThe user ID.
password
stringThe password for the given user.
context
Dictionary<string, string>The request context.
progress
IProgress<bool>The sent progress provider.
cancel
CancellationTokenA 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
CancellationTokenA 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
CancellationTokenA cancellation token that receives the cancellation requests.