---
name: "ACE_POSIX_Asynch_Write_File_Result"
section: "3"
platform: "linux"
package: "libace-doc"
version: "5.0.7-4"
release: "Debian 2.2 (Potato)"
platforms: ["linux"]
url: "https://new.carta.tech/ACE_POSIX_Asynch_Write_File_Result"
---

# ACE\_POSIX\_Asynch\_Write\_File\_Result(3)

This class provides implementation for ACE\_Asynch\_Write\_File\_Result for POSIX platforms.

## NAME

ACE\_POSIX\_Asynch\_Write\_File\_Result -

This class provides implementation for\
  ACE\_Asynch\_Write\_File\_Result for POSIX platforms.

## SYNOPSIS

```
class ACE_POSIX_Asynch_Write_File_Result :
  public virtual ACE_Asynch_Write_File_Result_Impl,
  public ACE_POSIX_Asynch_Write_Stream_Result
{
  public:
    friend class ACE_POSIX_AIOCB_Asynch_Write_File;
    friend class ACE_POSIX_SIG_Asynch_Write_File;
    friend class ACE_POSIX_Proactor;
    u_long bytes_transferred (void) const;
    const void *act (void) const;
    int success (void) const;
    const void *completion_key (void) const;
    u_long error (void) const;
    ACE_HANDLE event (void) const;
    u_long offset (void) const;
    u_long offset_high (void) const;
    int priority (void) const;
    int signal_number (void) const;
    u_long bytes_to_write (void) const;
    ACE_Message_Block &message_block (void) const;
    ACE_HANDLE handle (void) const;
    int post_completion (ACE_Proactor_Impl *proactor);
  protected:
    ACE_POSIX_Asynch_Write_File_Result (
        ACE_Handler &handler,
        ACE_HANDLE handle,
        ACE_Message_Block &message_block,
        u_long bytes_to_write,
        const void* act,
        u_long offset,
        u_long offset_high,
        ACE_HANDLE event,
        int priority,
        int signal_number
        );
    virtual void complete (
        u_long bytes_transferred,
        int success,
        const void *completion_key,
        u_long error
        );
    virtual ~ACE_POSIX_Asynch_Write_File_Result (void);
};
```

## DESCRIPTION

The implementation classes for POSIX implementation of Asynch Operations are defined here in this file.

## Base class operations. These operations are here to kill some

warnings. These methods call the base class methods.

```
u_long bytes_transferred (void) const;
```

Number of bytes transferred by the operation.

```
const void *act (void) const;
```

ACT associated with the operation.

```
int success (void) const;
```

Did the operation succeed?

```
const void *completion_key (void) const;
```

This is the ACT associated with the handle on which the Asynch\_Operation takes place.

@@ This is not implemented for POSIX4 platforms.

```
u_long error (void) const;
```

Error value if the operation fail.

```
ACE_HANDLE event (void) const;
```

This returns ACE\_INVALID\_HANDLE on POSIX4 platforms.

```
u_long offset (void) const;
```

```
u_long offset_high (void) const;
```

This really make sense only when doing file I/O.

@@ On POSIX4-Unix, offset\_high should be supported using\
     aiocb64.

```
int priority (void) const;
```

The priority of the asynchronous operation.

```
int signal_number (void) const;
```

POSIX4 real-time signal number to be used for the operation. signal\_number ranges from SIGRTMIN to SIGRTMAX. By  default, SIGRTMIN is used to issue aio\_ calls. This is a no-op on non-POSIX4 systems and returns 0.

## The following methods belong to

ACE\_POSIX\_Asynch\_Write\_Stream\_Result. They are here to avoid dominace warnings. These methods route their call to the  ACE\_POSIX\_Asynch\_Write\_Stream\_Result base class.

```
u_long bytes_to_write (void) const;
```

The number of bytes which were requested at the start of the asynchronous write.

```
ACE_Message_Block &message_block (void) const;
```

Message block that contains the data to be written.

```
ACE_HANDLE handle (void) const;
```

I/O handle used for writing.

```
int post_completion (ACE_Proactor_Impl *proactor);
```

Post this to the Proactor.

## AUTHOR

Irfan Pyarali (irfan@cs.wustl.edu), Tim Harrison (harrison@cs.wustl.edu) and Alexander Babu Arulanthu alex@cs.wustl.edu

## LIBRARY

ace