1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278
|
.TH ACE_WIN32_Asynch_Transmit_File_Result 3 "1 Dec 2001" "ACE" \" -*- nroff -*-
.ad l
.nh
.SH NAME
ACE_WIN32_Asynch_Transmit_File_Result \- This class implements \fBACE_Asynch_Transmit_File::Result\fR for WIN32 platforms.
.SH SYNOPSIS
.br
.PP
\fC#include <WIN32_Asynch_IO.h>\fR
.PP
Inherits \fBACE_Asynch_Transmit_File_Result_Impl\fR, and \fBACE_WIN32_Asynch_Result\fR.
.PP
.SS Public Methods
.in +1c
.ti -1c
.RI "ACE_HANDLE \fBsocket\fR (void) const"
.br
.RI "\fISocket used for transmitting the file.\fR"
.ti -1c
.RI "ACE_HANDLE \fBfile\fR (void) const"
.br
.RI "\fIFile from which the data is read.\fR"
.ti -1c
.RI "\fBACE_Asynch_Transmit_File::Header_And_Trailer\fR* \fBheader_and_trailer\fR (void) const"
.br
.RI "\fIHeader and trailer data associated with this transmit file.\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 transmit file.\fR"
.ti -1c
.RI "u_long \fBbytes_per_send\fR (void) const"
.br
.RI "\fINumber of bytes per send requested at the start of the transmit file.\fR"
.ti -1c
.RI "u_long \fBflags\fR (void) const"
.br
.RI "\fIFlags which were passed into transmit file.\fR"
.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 "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_Transmit_File_Result\fR (\fBACE_Handler\fR &handler, ACE_HANDLE socket, ACE_HANDLE file, \fBACE_Asynch_Transmit_File::Header_And_Trailer\fR *header_and_trailer, u_long bytes_to_write, u_long offset, u_long offset_high, u_long bytes_per_send, u_long flags, const void *act, 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 "\fIProactor will call this method when the write completes.\fR"
.ti -1c
.RI "virtual \fB~ACE_WIN32_Asynch_Transmit_File_Result\fR (void)"
.br
.RI "\fIDestructor.\fR"
.in -1c
.SS Protected Attributes
.in +1c
.ti -1c
.RI "ACE_HANDLE \fBsocket_\fR"
.br
.RI "\fINetwork I/O handle.\fR"
.ti -1c
.RI "ACE_HANDLE \fBfile_\fR"
.br
.RI "\fIFile I/O handle.\fR"
.ti -1c
.RI "\fBACE_Asynch_Transmit_File::Header_And_Trailer\fR* \fBheader_and_trailer_\fR"
.br
.RI "\fIHeader and trailer data associated with this transmit file.\fR"
.ti -1c
.RI "u_long \fBbytes_to_write_\fR"
.br
.RI "\fIThe number of bytes which were requested at the start of the asynchronous transmit file.\fR"
.ti -1c
.RI "u_long \fBbytes_per_send_\fR"
.br
.RI "\fINumber of bytes per send requested at the start of the transmit file.\fR"
.ti -1c
.RI "u_long \fBflags_\fR"
.br
.RI "\fIFlags which were passed into transmit file.\fR"
.in -1c
.SS Friends
.in +1c
.ti -1c
.RI "class \fBACE_WIN32_Asynch_Transmit_File\fR"
.br
.ti -1c
.RI "class \fBACE_WIN32_Proactor\fR"
.br
.in -1c
.SH DETAILED DESCRIPTION
.PP
This class implements \fBACE_Asynch_Transmit_File::Result\fR for WIN32 platforms.
.PP
.PP
This class has all the information necessary for the <handler> to uniquiely identify the completion of the asynchronous transmit file.
.PP
.SH CONSTRUCTOR & DESTRUCTOR DOCUMENTATION
.PP
.SS ACE_WIN32_Asynch_Transmit_File_Result::ACE_WIN32_Asynch_Transmit_File_Result (\fBACE_Handler\fR & handler, ACE_HANDLE socket, ACE_HANDLE file, \fBACE_Asynch_Transmit_File::Header_And_Trailer\fR * header_and_trailer, u_long bytes_to_write, u_long offset, u_long offset_high, u_long bytes_per_send, u_long flags, const void * act, ACE_HANDLE event, int priority, int signal_number = 0)\fC [protected]\fR
.PP
.SS ACE_WIN32_Asynch_Transmit_File_Result::~ACE_WIN32_Asynch_Transmit_File_Result (void)\fC [protected, virtual]\fR
.PP
Destructor.
.PP
.SH MEMBER FUNCTION DOCUMENTATION
.PP
.SS const void * ACE_WIN32_Asynch_Transmit_File_Result::act (void) const
.PP
ACT associated with the operation.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Result\fR.
.SS u_long ACE_WIN32_Asynch_Transmit_File_Result::bytes_per_send (void) const
.PP
Number of bytes per send requested at the start of the transmit file.
.PP
.SS u_long ACE_WIN32_Asynch_Transmit_File_Result::bytes_to_write (void) const
.PP
The number of bytes which were requested at the start of the asynchronous transmit file.
.PP
.SS u_long ACE_WIN32_Asynch_Transmit_File_Result::bytes_transferred (void) const
.PP
Number of bytes transferred by the operation.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Result\fR.
.SS void ACE_WIN32_Asynch_Transmit_File_Result::complete (u_long bytes_transferred, int success, const void * completion_key, u_long error)\fC [protected, virtual]\fR
.PP
Proactor will call this method when the write completes.
.PP
.SS const void * ACE_WIN32_Asynch_Transmit_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_Result\fR.
.SS u_long ACE_WIN32_Asynch_Transmit_File_Result::error (void) const
.PP
Error value if the operation fail.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Result\fR.
.SS ACE_HANDLE ACE_WIN32_Asynch_Transmit_File_Result::event (void) const
.PP
Event associated with the \fBOVERLAPPED\fR structure.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Result\fR.
.SS ACE_HANDLE ACE_WIN32_Asynch_Transmit_File_Result::file (void) const
.PP
File from which the data is read.
.PP
.SS u_long ACE_WIN32_Asynch_Transmit_File_Result::flags (void) const
.PP
Flags which were passed into transmit file.
.PP
.SS \fBACE_Asynch_Transmit_File::Header_And_Trailer\fR * ACE_WIN32_Asynch_Transmit_File_Result::header_and_trailer (void) const
.PP
Header and trailer data associated with this transmit file.
.PP
.SS u_long ACE_WIN32_Asynch_Transmit_File_Result::offset (void) const
.PP
This really make sense only when doing file I/O.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Result\fR.
.SS u_long ACE_WIN32_Asynch_Transmit_File_Result::offset_high (void) const
.PP
Offset_high associated with the \fBOVERLAPPED\fR structure.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Result\fR.
.SS int ACE_WIN32_Asynch_Transmit_File_Result::post_completion (\fBACE_Proactor_Impl\fR * proactor)
.PP
Post <this> to the Proactor's completion port.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Result\fR.
.SS int ACE_WIN32_Asynch_Transmit_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_Result\fR.
.SS int ACE_WIN32_Asynch_Transmit_File_Result::signal_number (void) const
.PP
No-op. Returns 0.
.PP
Reimplemented from \fBACE_WIN32_Asynch_Result\fR.
.SS ACE_HANDLE ACE_WIN32_Asynch_Transmit_File_Result::socket (void) const
.PP
Socket used for transmitting the file.
.PP
.SS int ACE_WIN32_Asynch_Transmit_File_Result::success (void) const
.PP
Did the operation succeed?
.PP
Reimplemented from \fBACE_WIN32_Asynch_Result\fR.
.SH FRIENDS AND RELATED FUNCTION DOCUMENTATION
.PP
.SS class ACE_WIN32_Asynch_Transmit_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_Result\fR.
.SH MEMBER DATA DOCUMENTATION
.PP
.SS u_long ACE_WIN32_Asynch_Transmit_File_Result::bytes_per_send_\fC [protected]\fR
.PP
Number of bytes per send requested at the start of the transmit file.
.PP
.SS u_long ACE_WIN32_Asynch_Transmit_File_Result::bytes_to_write_\fC [protected]\fR
.PP
The number of bytes which were requested at the start of the asynchronous transmit file.
.PP
.SS ACE_HANDLE ACE_WIN32_Asynch_Transmit_File_Result::file_\fC [protected]\fR
.PP
File I/O handle.
.PP
.SS u_long ACE_WIN32_Asynch_Transmit_File_Result::flags_\fC [protected]\fR
.PP
Flags which were passed into transmit file.
.PP
.SS \fBACE_Asynch_Transmit_File::Header_And_Trailer\fR * ACE_WIN32_Asynch_Transmit_File_Result::header_and_trailer_\fC [protected]\fR
.PP
Header and trailer data associated with this transmit file.
.PP
.SS ACE_HANDLE ACE_WIN32_Asynch_Transmit_File_Result::socket_\fC [protected]\fR
.PP
Network I/O handle.
.PP
.SH AUTHOR
.PP
Generated automatically by Doxygen for ACE from the source code.
|