* Annotate winsock.h.

svn path=/trunk/; revision=59745
This commit is contained in:
Amine Khaldi 2013-08-15 14:32:37 +00:00
parent e0532e413c
commit dabb39b31c

View file

@ -546,207 +546,207 @@ struct sockproto {
SOCKET SOCKET
PASCAL FAR PASCAL FAR
accept( accept(
IN SOCKET s, _In_ SOCKET s,
OUT struct sockaddr FAR *addr OPTIONAL, _Out_writes_bytes_opt_(*addrlen) struct sockaddr FAR *addr,
IN OUT int FAR *addrlen OPTIONAL); _Inout_opt_ int FAR *addrlen);
int int
PASCAL FAR PASCAL FAR
bind( bind(
IN SOCKET s, _In_ SOCKET s,
IN const struct sockaddr FAR *addr, _In_reads_bytes_(namelen) const struct sockaddr FAR *addr,
IN int namelen); _In_ int namelen);
int int
PASCAL FAR PASCAL FAR
closesocket( closesocket(
IN SOCKET s); _In_ SOCKET s);
int int
PASCAL FAR PASCAL FAR
connect( connect(
IN SOCKET s, _In_ SOCKET s,
IN const struct sockaddr FAR *name, _In_reads_bytes_(namelen) const struct sockaddr FAR *name,
IN int namelen); _In_ int namelen);
int int
PASCAL FAR PASCAL FAR
ioctlsocket( ioctlsocket(
IN SOCKET s, _In_ SOCKET s,
IN long cmd, _In_ long cmd,
IN OUT u_long FAR *argp); _Inout_ u_long FAR *argp);
int int
PASCAL FAR PASCAL FAR
getpeername( getpeername(
IN SOCKET s, _In_ SOCKET s,
OUT struct sockaddr FAR *name, _Out_writes_bytes_to_(*namelen, *namelen) struct sockaddr FAR *name,
IN OUT int FAR *namelen); _Inout_ int FAR *namelen);
int int
PASCAL FAR PASCAL FAR
getsockname( getsockname(
IN SOCKET s, _In_ SOCKET s,
OUT struct sockaddr FAR *name, _Out_writes_bytes_to_(*namelen, *namelen) struct sockaddr FAR *name,
IN OUT int FAR *namelen); _Inout_ int FAR *namelen);
int int
PASCAL FAR PASCAL FAR
getsockopt( getsockopt(
IN SOCKET s, _In_ SOCKET s,
IN int level, _In_ int level,
IN int optname, _In_ int optname,
OUT char FAR *optval, _Out_writes_bytes_(*optlen) char FAR *optval,
IN OUT int FAR *optlen); _Inout_ int FAR *optlen);
u_long u_long
PASCAL FAR PASCAL FAR
htonl( htonl(
IN u_long hostlong); _In_ u_long hostlong);
u_short u_short
PASCAL FAR PASCAL FAR
htons( htons(
IN u_short hostshort); _In_ u_short hostshort);
unsigned long unsigned long
PASCAL FAR PASCAL FAR
inet_addr( inet_addr(
IN const char FAR *cp); _In_z_ const char FAR *cp);
char FAR char FAR
*PASCAL FAR *PASCAL FAR
inet_ntoa( inet_ntoa(
IN struct in_addr in); _In_ struct in_addr in);
int int
PASCAL FAR PASCAL FAR
listen( listen(
IN SOCKET s, _In_ SOCKET s,
IN int backlog); _In_ int backlog);
u_long u_long
PASCAL FAR PASCAL FAR
ntohl( ntohl(
IN u_long netlong); _In_ u_long netlong);
u_short u_short
PASCAL FAR PASCAL FAR
ntohs( ntohs(
IN u_short netshort); _In_ u_short netshort);
int int
PASCAL FAR PASCAL FAR
recv( recv(
IN SOCKET s, _In_ SOCKET s,
OUT char FAR *buf, _Out_writes_bytes_to_(len, return) __out_data_source(NETWORK) char FAR *buf,
IN int len, _In_ int len,
IN int flags); _In_ int flags);
int int
PASCAL FAR PASCAL FAR
recvfrom( recvfrom(
IN SOCKET s, _In_ SOCKET s,
OUT char FAR *buf, _Out_writes_bytes_to_(len, return) __out_data_source(NETWORK) char FAR *buf,
IN int len, _In_ int len,
IN int flags, _In_ int flags,
OUT struct sockaddr FAR *from OPTIONAL, _Out_writes_bytes_to_opt_(*fromlen, *fromlen) struct sockaddr FAR *from,
IN OUT int FAR * fromlen OPTIONAL); _Inout_opt_ int FAR * fromlen);
int int
PASCAL FAR PASCAL FAR
select( select(
IN int nfds, _In_ int nfds,
IN OUT fd_set FAR *readfds OPTIONAL, _Inout_opt_ fd_set FAR *readfds,
IN OUT fd_set FAR *writefds OPTIONAL, _Inout_opt_ fd_set FAR *writefds,
IN OUT fd_set FAR *exceptfds OPTIONAL, _Inout_opt_ fd_set FAR *exceptfds,
IN const struct timeval FAR *timeout OPTIONAL); _In_opt_ const struct timeval FAR *timeout);
int int
PASCAL FAR PASCAL FAR
send( send(
IN SOCKET s, _In_ SOCKET s,
IN const char FAR *buf, _In_reads_bytes_(len) const char FAR *buf,
IN int len, _In_ int len,
IN int flags); _In_ int flags);
int int
PASCAL FAR PASCAL FAR
sendto( sendto(
IN SOCKET s, _In_ SOCKET s,
IN const char FAR *buf, _In_reads_bytes_(len) const char FAR *buf,
IN int len, _In_ int len,
IN int flags, _In_ int flags,
IN const struct sockaddr FAR *to OPTIONAL, _In_reads_bytes_opt_(tolen) const struct sockaddr FAR *to,
IN int tolen); _In_ int tolen);
int int
PASCAL FAR PASCAL FAR
setsockopt( setsockopt(
IN SOCKET s, _In_ SOCKET s,
IN int level, _In_ int level,
IN int optname, _In_ int optname,
IN const char FAR *optval OPTIONAL, _In_reads_bytes_opt_(optlen) const char FAR *optval,
IN int optlen); _In_ int optlen);
int int
PASCAL FAR PASCAL FAR
shutdown( shutdown(
IN SOCKET s, _In_ SOCKET s,
IN int how); _In_ int how);
SOCKET SOCKET
PASCAL FAR PASCAL FAR
socket( socket(
IN int af, _In_ int af,
IN int type, _In_ int type,
IN int protocol); _In_ int protocol);
struct hostent FAR struct hostent FAR
*PASCAL FAR *PASCAL FAR
gethostbyaddr( gethostbyaddr(
IN const char FAR *addr, _In_reads_bytes_(len) const char FAR *addr,
IN int len, _In_ int len,
IN int type); _In_ int type);
struct hostent FAR struct hostent FAR
*PASCAL FAR *PASCAL FAR
gethostbyname( gethostbyname(
IN const char FAR *name); _In_z_ const char FAR *name);
int int
PASCAL FAR PASCAL FAR
gethostname( gethostname(
OUT char FAR *name, _Out_writes_bytes_to_(namelen, return) char FAR *name,
IN int namelen); _In_ int namelen);
struct servent FAR struct servent FAR
*PASCAL FAR *PASCAL FAR
getservbyport( getservbyport(
IN int port, _In_ int port,
IN const char FAR *proto); _In_z_ const char FAR *proto);
struct servent FAR struct servent FAR
*PASCAL FAR *PASCAL FAR
getservbyname( getservbyname(
IN const char FAR *name, _In_z_ const char FAR *name,
IN const char FAR *proto); _In_z_ const char FAR *proto);
struct protoent FAR struct protoent FAR
*PASCAL FAR *PASCAL FAR
getprotobynumber( getprotobynumber(
IN int number); _In_ int number);
struct protoent FAR struct protoent FAR
*PASCAL FAR *PASCAL FAR
getprotobyname( getprotobyname(
IN const char FAR *name); _In_z_ const char FAR *name);
int int
PASCAL FAR PASCAL FAR
WSAStartup( WSAStartup(
IN WORD wVersionRequired, _In_ WORD wVersionRequired,
OUT LPWSADATA lpWSAData); _Out_ LPWSADATA lpWSAData);
int int
PASCAL FAR PASCAL FAR
@ -755,7 +755,7 @@ WSACleanup(void);
void void
PASCAL FAR PASCAL FAR
WSASetLastError( WSASetLastError(
IN int iError); _In_ int iError);
int int
PASCAL FAR PASCAL FAR
@ -772,7 +772,7 @@ WSAUnhookBlockingHook(void);
FARPROC FARPROC
PASCAL FAR PASCAL FAR
WSASetBlockingHook( WSASetBlockingHook(
IN FARPROC lpBlockFunc); _In_ FARPROC lpBlockFunc);
int int
PASCAL FAR PASCAL FAR
@ -781,81 +781,81 @@ WSACancelBlockingCall(void);
HANDLE HANDLE
PASCAL FAR PASCAL FAR
WSAAsyncGetServByName( WSAAsyncGetServByName(
IN HWND hWnd, _In_ HWND hWnd,
IN u_int wMsg, _In_ u_int wMsg,
IN const char FAR *name, _In_z_ const char FAR *name,
IN const char FAR *proto, _In_z_ const char FAR *proto,
OUT char FAR *buf, _Out_writes_bytes_(buflen) char FAR *buf,
IN int buflen); _In_ int buflen);
HANDLE HANDLE
PASCAL FAR PASCAL FAR
WSAAsyncGetServByPort( WSAAsyncGetServByPort(
IN HWND hWnd, _In_ HWND hWnd,
IN u_int wMsg, _In_ u_int wMsg,
IN int port, _In_ int port,
IN const char FAR *proto, _In_ const char FAR *proto,
OUT char FAR *buf, _Out_writes_bytes_(buflen) char FAR *buf,
IN int buflen); _In_ int buflen);
HANDLE HANDLE
PASCAL FAR PASCAL FAR
WSAAsyncGetProtoByName( WSAAsyncGetProtoByName(
IN HWND hWnd, _In_ HWND hWnd,
IN u_int wMsg, _In_ u_int wMsg,
IN const char FAR *name, _In_z_ const char FAR *name,
OUT char FAR *buf, _Out_writes_bytes_(buflen) char FAR *buf,
IN int buflen); _In_ int buflen);
HANDLE HANDLE
PASCAL FAR PASCAL FAR
WSAAsyncGetProtoByNumber( WSAAsyncGetProtoByNumber(
IN HWND hWnd, _In_ HWND hWnd,
IN u_int wMsg, _In_ u_int wMsg,
IN int number, _In_ int number,
OUT char FAR *buf, _Out_writes_bytes_(buflen) char FAR *buf,
IN int buflen); _In_ int buflen);
HANDLE HANDLE
PASCAL FAR PASCAL FAR
WSAAsyncGetHostByName( WSAAsyncGetHostByName(
IN HWND hWnd, _In_ HWND hWnd,
IN u_int wMsg, _In_ u_int wMsg,
IN const char FAR *name, _In_z_ const char FAR *name,
OUT char FAR *buf, _Out_writes_bytes_(buflen) char FAR *buf,
IN int buflen); _In_ int buflen);
HANDLE HANDLE
PASCAL FAR PASCAL FAR
WSAAsyncGetHostByAddr( WSAAsyncGetHostByAddr(
IN HWND hWnd, _In_ HWND hWnd,
IN u_int wMsg, _In_ u_int wMsg,
IN const char FAR *addr, _In_ const char FAR *addr,
IN int len, _In_ int len,
IN int type, _In_ int type,
OUT char FAR *buf, _Out_writes_bytes_(buflen) char FAR *buf,
IN int buflen); _In_ int buflen);
int int
PASCAL FAR PASCAL FAR
WSACancelAsyncRequest( WSACancelAsyncRequest(
IN HANDLE hAsyncTaskHandle); _In_ HANDLE hAsyncTaskHandle);
int int
PASCAL FAR PASCAL FAR
WSAAsyncSelect( WSAAsyncSelect(
IN SOCKET s, _In_ SOCKET s,
IN HWND hWnd, _In_ HWND hWnd,
IN u_int wMsg, _In_ u_int wMsg,
IN long lEvent); _In_ long lEvent);
int int
PASCAL FAR PASCAL FAR
WSARecvEx( WSARecvEx(
IN SOCKET s, _In_ SOCKET s,
OUT char FAR *buf, _Out_writes_bytes_to_(len, return) __out_data_source(NETWORK) char FAR *buf,
IN int len, _In_ int len,
IN OUT int FAR *flags); _Inout_ int FAR *flags);
typedef struct _TRANSMIT_FILE_BUFFERS { typedef struct _TRANSMIT_FILE_BUFFERS {
PVOID Head; PVOID Head;
@ -867,37 +867,37 @@ typedef struct _TRANSMIT_FILE_BUFFERS {
BOOL BOOL
PASCAL FAR PASCAL FAR
TransmitFile( TransmitFile(
IN SOCKET hSocket, _In_ SOCKET hSocket,
IN HANDLE hFile, _In_ HANDLE hFile,
IN DWORD nNumberOfBytesToWrite, _In_ DWORD nNumberOfBytesToWrite,
IN DWORD nNumberOfBytesPerSend, _In_ DWORD nNumberOfBytesPerSend,
IN OUT LPOVERLAPPED lpOverlapped OPTIONAL, _Inout_opt_ LPOVERLAPPED lpOverlapped,
IN LPTRANSMIT_FILE_BUFFERS lpTransmitBuffers OPTIONAL, _In_opt_ LPTRANSMIT_FILE_BUFFERS lpTransmitBuffers,
IN DWORD dwReserved); _In_ DWORD dwReserved);
BOOL BOOL
PASCAL FAR PASCAL FAR
AcceptEx( AcceptEx(
IN SOCKET sListenSocket, _In_ SOCKET sListenSocket,
IN SOCKET sAcceptSocket, _In_ SOCKET sAcceptSocket,
OUT PVOID lpOutputBuffer, _Out_writes_bytes_to_(dwReceiveDataLength + dwLocalAddressLength + dwRemoteAddressLength, *lpdwBytesReceived) PVOID lpOutputBuffer,
IN DWORD dwReceiveDataLength, _In_ DWORD dwReceiveDataLength,
IN DWORD dwLocalAddressLength, _In_ DWORD dwLocalAddressLength,
IN DWORD dwRemoteAddressLength, _In_ DWORD dwRemoteAddressLength,
OUT LPDWORD lpdwBytesReceived, _Out_ LPDWORD lpdwBytesReceived,
IN OUT LPOVERLAPPED lpOverlapped); _Inout_ LPOVERLAPPED lpOverlapped);
VOID VOID
PASCAL FAR PASCAL FAR
GetAcceptExSockaddrs( GetAcceptExSockaddrs(
IN PVOID lpOutputBuffer, _In_reads_bytes_(dwReceiveDataLength + dwLocalAddressLength + dwRemoteAddressLength) PVOID lpOutputBuffer,
IN DWORD dwReceiveDataLength, _In_ DWORD dwReceiveDataLength,
IN DWORD dwLocalAddressLength, _In_ DWORD dwLocalAddressLength,
IN DWORD dwRemoteAddressLength, _In_ DWORD dwRemoteAddressLength,
OUT struct sockaddr **LocalSockaddr, _Outptr_result_bytebuffer_(*LocalSockaddrLength) struct sockaddr **LocalSockaddr,
OUT LPINT LocalSockaddrLength, _Out_ LPINT LocalSockaddrLength,
OUT struct sockaddr **RemoteSockaddr, _Outptr_result_bytebuffer_(*RemoteSockaddrLength) struct sockaddr **RemoteSockaddr,
OUT LPINT RemoteSockaddrLength); _Out_ LPINT RemoteSockaddrLength);
#if(_WIN32_WINNT >= 0x0501) #if(_WIN32_WINNT >= 0x0501)