class Binding

Constructs an incomplete binding that will use the implementation |impl|.

The binding may be completed with a subsequent call to the |Bind| method.

Does not take ownership of |impl|, which must outlive the binding.

Constructs a completed binding of |channel| to implementation |impl|.

Does not take ownership of |impl|, which must outlive the binding.

If the |Binding| cannot be bound to the given |channel| (e.g., because

the |channel| lacks |ZX_RIGHT_WAIT|), the |Binding| will be constructed

in an unbound state.

Uses the given async_dispatcher_t (e.g., a message loop) in order to read

messages from the channel and to monitor the channel for

|ZX_CHANNEL_PEER_CLOSED|. If |dispatcher| is null, the current thread must

have a default async_dispatcher_t.

Constructs a completed binding of |impl| to the channel in |request|.

Does not take ownership of |impl|, which must outlive the binding.

If the |Binding| cannot be bound to the given |channel| (e.g., because

the |channel| lacks |ZX_RIGHT_WAIT|), the |Binding| will be constructed

in an unbound state.

Uses the given async_dispatcher_t (e.g., a message loop) in order to read

messages from the channel and to monitor the channel for

|ZX_CHANNEL_PEER_CLOSED|. If |dispatcher| is null, the current thread must

have a default async_dispatcher_t.

The implementation of this class provides external references to class members via pointers.

As a result, instances cannot be move-constructed or move-assigned.

Completes a binding by creating a new channel, binding one endpoint to

the previously specified implementation and returning the other endpoint.

If |NewBinding| fails to create the underlying channel, the returned

|InterfaceHandle| will return false from |is_valid()|.

Uses the given async_dispatcher_t (e.g., a message loop) in order to read

messages from the channel and to monitor the channel for

|ZX_CHANNEL_PEER_CLOSED|. If |dispatcher| is null, the current thread must

have a default async_dispatcher_t.

Binds the previously specified implementation to the given |channel|.

If the |Binding| was previously bound to another channel, that channel is

closed.

Uses the given async_dispatcher_t (e.g., a message loop) in order to read

messages from the channel and to monitor the channel for

|ZX_CHANNEL_PEER_CLOSED|. If |dispatcher| is null, the current thread must

have a default async_dispatcher_t.

Returns an error if the binding was not able to be created (e.g., because

the |channel| lacks |ZX_RIGHT_WAIT|).

Binds the previously specified implementation to the given

|InterfaceRequest|.

If the |Binding| was previously bound to another channel, that channel is

closed.

Uses the given async_dispatcher_t (e.g., a message loop) in order to read

messages from the channel and to monitor the channel for

|ZX_CHANNEL_PEER_CLOSED|. If |dispatcher| is null, the current thread must

have a default async_dispatcher_t.

Returns an error if the binding was not able to be created (e.g., because

the |channel| lacks |ZX_RIGHT_WAIT|).

Unbinds the underlying channel from this binding and returns it so it can

be used in another context, such as on another thread or with a different

implementation.

After this function returns, the |Binding| is ready to be bound to another

channel.

Sends an Epitaph over the bound channel corresponding to the error passed

as a parameter, closes the channel, and unbinds it. An Epitaph is the last

message sent over a channel before a close operation; for the purposes of

this function, it can be thought of as a return code. See the FIDL

language spec for more information about Epitaphs.

The return value can be any of the return values of zx_channel_write.

Blocks the calling thread until either a message arrives on the previously

bound channel or an error occurs.

Returns an error if waiting for the message, reading the message, or

processing the message fails. If the error results in the channel being

closed, the error handler will be called synchronously before this

method returns.

This method can be called only if this |Binding| is currently bound to a

channel.

Whether an error handler has been set.

See |set_error_handler()|.

Sets an error handler that will be called if an error causes the underlying

channel to be closed.

If the error is being reported because an error occurred on the local side

of the channel, the zx_status_t of that error will be passed as the

parameter to the handler.

For example, the error handler will be called if the remote side of the

channel sends an invalid message. When the error handler is called, the

|Binding| will no longer be bound to the channel.

The implementation used by this |Binding| to process incoming messages.

The interface for sending events back to the client.

Whether this |Binding| is currently listening to a channel.

The underlying channel.

The |async_dispatcher_t| to which this binding is bound, if any.