---
name: "Net::DBus::Binding::PendingCall"
section: "3pm"
platform: "linux"
package: "perl-net-dbus"
version: "1.2.0-9"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Net::DBus::Binding::PendingCall"
---

# Net::DBus::Binding::PendingCall(3pm)

A handler for pending method replies

## 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