GUPnP.Acl.is_allowed_async

### Method

# GUPnP Aclis_allowed_async

since: 0.20.11

#### Declaration [src]

    void
    gupnp_acl_is_allowed_async (
      GUPnPAcl* self,
      GUPnPDevice* device,
      GUPnPService* service,
      const char* path,
      const char* address,
      const char* agent,
      GCancellable* cancellable,
      GAsyncReadyCallback callback,
      gpointer user_data
    )

#### Description [src]

Check asynchronously whether an IP address is allowed to access this resource.

This function is optional. `gupnp_acl_can_sync()` should return `TRUE` if the implementing class supports it. If it is supported, GUPnP will prefer to use this function over `gupnp_acl_is_allowed()`.

Implement this function if the process of verifying the access right is expected to take some time, for example when using D-Bus etc.

Use `gupnp_acl_is_allowed_finish()` to retrieve the result.

Available since: 0.20.11

This method completes asynchronously. Use `gupnp_acl_is_allowed_finish()` inside the `GAsyncReadyCallback` to obtain the result of the operation.

#### Parameters

`device`

  Type: `GUPnPDevice`

  The `GUPnPDevice` associated with `path` or `NULL` if unknown.

  The argument can be `NULL`.
  The data is owned by the caller of the method.

`service`

  Type: `GUPnPService`

  The `GUPnPService` associated with `path` or `NULL` if unknown.

  The argument can be `NULL`.
  The data is owned by the caller of the method.

`path`

  Type: `const char*`

  The path being served.

  The data is owned by the caller of the method.
  The value is a NUL terminated UTF-8 string.

`address`

  Type: `const char*`

  IP address of the peer.

  The data is owned by the caller of the method.
  The value is a NUL terminated UTF-8 string.

`agent`

  Type: `const char*`

  The User-Agent header of the peer or `NULL` if not unknown.

  The argument can be `NULL`.
  The data is owned by the caller of the method.
  The value is a NUL terminated UTF-8 string.

`cancellable`

  Type: `GCancellable`

  A cancellable which can be used to cancel the operation.

  The argument can be `NULL`.
  The data is owned by the caller of the method.

`callback`

  Type: `GAsyncReadyCallback`

  Callback to call after the function is done.

  The argument can be `NULL`.

`user_data`

  Type: `gpointer`

  Some user data.

  The argument can be `NULL`.
  The data is owned by the caller of the method.