.TH ACE_WIN32_Asynch_Write_File_Result 3 "1 Dec 2001" "ACE" \" -*- nroff -*-
.ad l
.nh
.SH NAME
ACE_WIN32_Asynch_Write_File_Result \- This class provides implementation for ACE_Asynch_Write_File_Result for WIN32 platforms. 
.SH SYNOPSIS
.br
.PP
\fC#include <WIN32_Asynch_IO.h>\fR
.PP
Inherits \fBACE_Asynch_Write_File_Result_Impl\fR, and \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.PP
.SS Public Methods

.in +1c
.ti -1c
.RI "u_long \fBbytes_transferred\fR (void) const"
.br
.RI "\fINumber of bytes transferred by the operation.\fR"
.ti -1c
.RI "const void* \fBact\fR (void) const"
.br
.RI "\fIACT associated with the operation.\fR"
.ti -1c
.RI "int \fBsuccess\fR (void) const"
.br
.RI "\fIDid the operation succeed?\fR"
.ti -1c
.RI "const void* \fBcompletion_key\fR (void) const"
.br
.ti -1c
.RI "u_long \fBerror\fR (void) const"
.br
.RI "\fIError value if the operation fail.\fR"
.ti -1c
.RI "ACE_HANDLE \fBevent\fR (void) const"
.br
.RI "\fIEvent associated with the \fBOVERLAPPED\fR structure.\fR"
.ti -1c
.RI "u_long \fBoffset\fR (void) const"
.br
.RI "\fIThis really make sense only when doing file I/O.\fR"
.ti -1c
.RI "u_long \fBoffset_high\fR (void) const"
.br
.RI "\fIOffset_high associated with the \fBOVERLAPPED\fR structure.\fR"
.ti -1c
.RI "int \fBpriority\fR (void) const"
.br
.RI "\fIThe priority of the asynchronous operation. Currently, this is not supported on Win32.\fR"
.ti -1c
.RI "int \fBsignal_number\fR (void) const"
.br
.RI "\fINo-op. Returns 0.\fR"
.ti -1c
.RI "u_long \fBbytes_to_write\fR (void) const"
.br
.RI "\fIThe number of bytes which were requested at the start of the asynchronous write.\fR"
.ti -1c
.RI "\fBACE_Message_Block\fR& \fBmessage_block\fR (void) const"
.br
.RI "\fIMessage block that contains the data to be written.\fR"
.ti -1c
.RI "ACE_HANDLE \fBhandle\fR (void) const"
.br
.RI "\fII/O handle used for writing.\fR"
.ti -1c
.RI "int \fBpost_completion\fR (\fBACE_Proactor_Impl\fR *proactor)"
.br
.RI "\fIPost <this> to the Proactor's completion port.\fR"
.in -1c
.SS Protected Methods

.in +1c
.ti -1c
.RI "\fBACE_WIN32_Asynch_Write_File_Result\fR (\fBACE_Handler\fR &handler, ACE_HANDLE handle, \fBACE_Message_Block\fR &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 = 0)"
.br
.ti -1c
.RI "virtual void \fBcomplete\fR (u_long bytes_transferred, int success, const void *completion_key, u_long error)"
.br
.RI "\fI\fBACE_Proactor\fR will call this method when the write completes.\fR"
.ti -1c
.RI "virtual \fB~ACE_WIN32_Asynch_Write_File_Result\fR (void)"
.br
.RI "\fIDestructor.\fR"
.in -1c
.SS Friends

.in +1c
.ti -1c
.RI "class \fBACE_WIN32_Asynch_Write_File\fR"
.br
.ti -1c
.RI "class \fBACE_WIN32_Proactor\fR"
.br
.in -1c
.SH DETAILED DESCRIPTION
.PP 
This class provides implementation for ACE_Asynch_Write_File_Result for WIN32 platforms.
.PP
.PP
 This class has all the information necessary for the <handler> to uniquiely identify the completion of the asynchronous write.
.PP
This class differs slightly from \fBACE_Asynch_Write_Stream::Result\fR as it calls back  on the <handler> instead of . No additional state is required by this class as \fBACE_Asynch_Result\fR can store the <offset>. 
.PP
.SH CONSTRUCTOR & DESTRUCTOR DOCUMENTATION
.PP 
.SS ACE_WIN32_Asynch_Write_File_Result::ACE_WIN32_Asynch_Write_File_Result (\fBACE_Handler\fR & handler, ACE_HANDLE handle, \fBACE_Message_Block\fR & 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 = 0)\fC [protected]\fR
.PP
.SS ACE_WIN32_Asynch_Write_File_Result::~ACE_WIN32_Asynch_Write_File_Result (void)\fC [protected, virtual]\fR
.PP
Destructor.
.PP
.SH MEMBER FUNCTION DOCUMENTATION
.PP 
.SS const void * ACE_WIN32_Asynch_Write_File_Result::act (void) const
.PP
ACT associated with the operation.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS u_long ACE_WIN32_Asynch_Write_File_Result::bytes_to_write (void) const
.PP
The number of bytes which were requested at the start of the asynchronous write.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS u_long ACE_WIN32_Asynch_Write_File_Result::bytes_transferred (void) const
.PP
Number of bytes transferred by the operation.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS void ACE_WIN32_Asynch_Write_File_Result::complete (u_long bytes_transferred, int success, const void * completion_key, u_long error)\fC [protected, virtual]\fR
.PP
\fBACE_Proactor\fR will call this method when the write completes.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS const void * ACE_WIN32_Asynch_Write_File_Result::completion_key (void) const
.PP
This returns the ACT associated with the handle when it was registered with the I/O completion port. This ACT is not the same as the ACT associated with the asynchronous operation. 
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS u_long ACE_WIN32_Asynch_Write_File_Result::error (void) const
.PP
Error value if the operation fail.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS ACE_HANDLE ACE_WIN32_Asynch_Write_File_Result::event (void) const
.PP
Event associated with the \fBOVERLAPPED\fR structure.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS ACE_HANDLE ACE_WIN32_Asynch_Write_File_Result::handle (void) const
.PP
I/O handle used for writing.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS \fBACE_Message_Block\fR & ACE_WIN32_Asynch_Write_File_Result::message_block (void) const
.PP
Message block that contains the data to be written.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS u_long ACE_WIN32_Asynch_Write_File_Result::offset (void) const
.PP
This really make sense only when doing file I/O.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS u_long ACE_WIN32_Asynch_Write_File_Result::offset_high (void) const
.PP
Offset_high associated with the \fBOVERLAPPED\fR structure.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS int ACE_WIN32_Asynch_Write_File_Result::post_completion (\fBACE_Proactor_Impl\fR * proactor)
.PP
Post <this> to the Proactor's completion port.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS int ACE_WIN32_Asynch_Write_File_Result::priority (void) const
.PP
The priority of the asynchronous operation. Currently, this is not supported on Win32.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS int ACE_WIN32_Asynch_Write_File_Result::signal_number (void) const
.PP
No-op. Returns 0.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SS int ACE_WIN32_Asynch_Write_File_Result::success (void) const
.PP
Did the operation succeed?
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.
.SH FRIENDS AND RELATED FUNCTION DOCUMENTATION
.PP 
.SS class ACE_WIN32_Asynch_Write_File\fC [friend]\fR
.PP
Factory class will have special permission.
.PP
.SS class ACE_WIN32_Proactor\fC [friend]\fR
.PP
Proactor class has special permission.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Write_Stream_Result\fR.

.SH AUTHOR
.PP 
Generated automatically by Doxygen for ACE from the source code.