Man page of Net::DBus::Binding::PendingCall

Net::DBus::Binding::PendingCall

Section: User Contributed Perl Documentation (3pm)

Updated: 2011-06-30

Index?action=index Return to Main Contents


NAME

Net::DBus::Binding::PendingCall - A handler for pending method replies

SYNOPSIS

  my $call = Net::DBus::Binding::PendingCall->new(method_call => $call,
                                                  pending_call => $reply);

  # Wait for completion
  $call->block;

  # And get the reply message
  my $msg = $call->get_reply;

DESCRIPTION

This object is used when it is necessary to make asynchronous method calls. It provides the means to be notified when the reply is finally received.

METHODS

my $call = Net
:DBus::Binding::PendingCall->new(method_call => $method_call, pending_call => $pending_call);:Creates a new pending call object, with the
 "method_call"
parameter being a reference to the
 "Net::DBus::Binding::Message::MethodCall"
object whose reply is being waiting for. The
 "pending_call"
parameter is a reference to the raw C pending call object.:
$call->cancel
Cancel the pending call, causing any reply that is later received to be discarded.:
my $boolean = $call->get_completed
Returns a true value if the pending call has received its reply, or a timeout has occurred.:
$call->block
Block the caller until the reply is received or a timeout occurrs.:
my $msg = $call->get_reply;
Retrieves the
 "Net::DBus::Binding::Message"
object associated with the complete call.:
$call->set_notify($coderef);
Sets a notification function to be invoked when the pending call completes. The callback will be passed a single argument which is this pending call object.:

AUTHOR

Daniel P. Berrange

COPYRIGHT

Copyright (C) 2006-2011 Daniel P. Berrange

SEE ALSO

Net::DBus::Binding::Connection, Net::DBus::Binding::Message, Net::DBus::ASyncReply


Index

NAME

SYNOPSIS

DESCRIPTION

METHODS

AUTHOR

COPYRIGHT

SEE ALSO