Author: akhaldi Date: Thu Aug 15 12:59:02 2013 New Revision: 59743
URL: http://svn.reactos.org/svn/reactos?rev=59743&view=rev Log: [PSDK] * Annotate ws2tcpip.h.
Modified: trunk/reactos/include/psdk/ws2tcpip.h
Modified: trunk/reactos/include/psdk/ws2tcpip.h URL: http://svn.reactos.org/svn/reactos/trunk/reactos/include/psdk/ws2tcpip.h?rev... ============================================================================== --- trunk/reactos/include/psdk/ws2tcpip.h [iso-8859-1] (original) +++ trunk/reactos/include/psdk/ws2tcpip.h [iso-8859-1] Thu Aug 15 12:59:02 2013 @@ -62,10 +62,10 @@ INT WSAAPI getaddrinfo( - IN PCSTR pNodeName OPTIONAL, - IN PCSTR pServiceName OPTIONAL, - IN const ADDRINFOA *pHints OPTIONAL, - OUT PADDRINFOA *ppResult); + _In_opt_ PCSTR pNodeName, + _In_opt_ PCSTR pServiceName, + _In_opt_ const ADDRINFOA *pHints, + _Outptr_ PADDRINFOA *ppResult);
#if (NTDDI_VERSION >= NTDDI_WINXPSP2) || (_WIN32_WINNT >= 0x0502)
@@ -73,10 +73,10 @@ INT WSAAPI GetAddrInfoW( - IN PCWSTR pNodeName OPTIONAL, - IN PCWSTR pServiceName OPTIONAL, - IN const ADDRINFOW *pHints OPTIONAL, - OUT PADDRINFOW *ppResult); + _In_opt_ PCWSTR pNodeName, + _In_opt_ PCWSTR pServiceName, + _In_opt_ const ADDRINFOW *pHints, + _Outptr_ PADDRINFOW *ppResult);
#define GetAddrInfoA getaddrinfo
@@ -92,17 +92,17 @@
typedef INT (WSAAPI *LPFN_GETADDRINFO)( - IN PCSTR pNodeName OPTIONAL, - IN PCSTR pServiceName OPTIONAL, - IN const ADDRINFOA *pHints OPTIONAL, - OUT PADDRINFOA *ppResult); + _In_opt_ PCSTR pNodeName, + _In_opt_ PCSTR pServiceName, + _In_opt_ const ADDRINFOA *pHints, + _Outptr_ PADDRINFOA *ppResult);
typedef INT (WSAAPI *LPFN_GETADDRINFOW)( - IN PCWSTR pNodeName OPTIONAL, - IN PCWSTR pServiceName OPTIONAL, - IN const ADDRINFOW *pHints OPTIONAL, - OUT PADDRINFOW *ppResult); + _In_opt_ PCWSTR pNodeName, + _In_opt_ PCWSTR pServiceName, + _In_opt_ const ADDRINFOW *pHints, + _Outptr_ PADDRINFOW *ppResult);
#define LPFN_GETADDRINFOA LPFN_GETADDRINFO
@@ -118,39 +118,39 @@
typedef void (CALLBACK *LPLOOKUPSERVICE_COMPLETION_ROUTINE)( - IN DWORD dwError, - IN DWORD dwBytes, - IN LPWSAOVERLAPPED lpOverlapped); + _In_ DWORD dwError, + _In_ DWORD dwBytes, + _In_ LPWSAOVERLAPPED lpOverlapped);
WINSOCK_API_LINKAGE INT WSAAPI GetAddrInfoExA( - IN PCSTR pName OPTIONAL, - IN PCSTR pServiceName OPTIONAL, - IN DWORD dwNameSpace, - IN LPGUID lpNspId OPTIONAL, - IN const ADDRINFOEXA *hints, - OUT PADDRINFOEXA *ppResult, - IN struct timeval *timeout OPTIONAL, - IN LPOVERLAPPED lpOverlapped OPTIONAL, - IN LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine OPTIONAL, - OUT LPHANDLE lpNameHandle OPTIONAL); + _In_opt_ PCSTR pName, + _In_opt_ PCSTR pServiceName, + _In_ DWORD dwNameSpace, + _In_opt_ LPGUID lpNspId, + _In_opt_ const ADDRINFOEXA *hints, + _Outptr_ PADDRINFOEXA *ppResult, + _In_opt_ struct timeval *timeout, + _In_opt_ LPOVERLAPPED lpOverlapped, + _In_opt_ LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine, + _Out_opt_ LPHANDLE lpNameHandle);
WINSOCK_API_LINKAGE INT WSAAPI GetAddrInfoExW( - IN PCWSTR pName OPTIONAL, - IN PCWSTR pServiceName OPTIONAL, - IN DWORD dwNameSpace, - IN LPGUID lpNspId OPTIONAL, - IN const ADDRINFOEXW *hints OPTIONAL, - OUT PADDRINFOEXW *ppResult, - IN struct timeval *timeout OPTIONAL, - IN LPOVERLAPPED lpOverlapped OPTIONAL, - IN LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine OPTIONAL, - OUT LPHANDLE lpHandle OPTIONAL); + _In_opt_ PCWSTR pName, + _In_opt_ PCWSTR pServiceName, + _In_ DWORD dwNameSpace, + _In_opt_ LPGUID lpNspId, + _In_opt_ const ADDRINFOEXW *hints, + _Outptr_ PADDRINFOEXW *ppResult, + _In_opt_ struct timeval *timeout, + _In_opt_ LPOVERLAPPED lpOverlapped, + _In_opt_ LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine, + _Out_opt_ LPHANDLE lpHandle);
#ifdef UNICODE #define GetAddrInfoEx GetAddrInfoExW @@ -162,29 +162,29 @@
typedef INT (WSAAPI *LPFN_GETADDRINFOEXA)( - IN PCSTR pName, - IN PCSTR pServiceName OPTIONAL, - IN DWORD dwNameSpace, - IN LPGUID lpNspId OPTIONAL, - IN const ADDRINFOEXA *hints OPTIONAL, - OUT PADDRINFOEXA *ppResult, - IN struct timeval *timeout OPTIONAL, - IN LPOVERLAPPED lpOverlapped OPTIONAL, - IN LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine OPTIONAL, - OUT LPHANDLE lpNameHandle OPTIONAL); + _In_ PCSTR pName, + _In_opt_ PCSTR pServiceName, + _In_ DWORD dwNameSpace, + _In_opt_ LPGUID lpNspId, + _In_opt_ const ADDRINFOEXA *hints, + _Outptr_ PADDRINFOEXA *ppResult, + _In_opt_ struct timeval *timeout, + _In_opt_ LPOVERLAPPED lpOverlapped, + _In_opt_ LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine, + _Out_opt_ LPHANDLE lpNameHandle);
typedef INT (WSAAPI *LPFN_GETADDRINFOEXW)( - IN PCWSTR pName, - IN PCWSTR pServiceName OPTIONAL, - IN DWORD dwNameSpace, - IN LPGUID lpNspId OPTIONAL, - IN const ADDRINFOEXW *hints OPTIONAL, - OUT PADDRINFOEXW *ppResult, - IN struct timeval *timeout OPTIONAL, - IN LPOVERLAPPED lpOverlapped OPTIONAL, - IN LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine OPTIONAL, - OUT LPHANDLE lpHandle OPTIONAL); + _In_ PCWSTR pName, + _In_opt_ PCWSTR pServiceName, + _In_ DWORD dwNameSpace, + _In_opt_ LPGUID lpNspId, + _In_opt_ const ADDRINFOEXW *hints, + _Outptr_ PADDRINFOEXW *ppResult, + _In_opt_ struct timeval *timeout, + _In_opt_ LPOVERLAPPED lpOverlapped, + _In_opt_ LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine, + _Out_opt_ LPHANDLE lpHandle);
#ifdef UNICODE #define LPFN_GETADDRINFOEX LPFN_GETADDRINFOEXW @@ -201,35 +201,35 @@ INT WSAAPI SetAddrInfoExA( - IN PCSTR pName, - IN PCSTR pServiceName OPTIONAL, - IN SOCKET_ADDRESS *pAddresses OPTIONAL, - IN DWORD dwAddressCount, - IN LPBLOB lpBlob OPTIONAL, - IN DWORD dwFlags, - IN DWORD dwNameSpace, - IN LPGUID lpNspId OPTIONAL, - IN struct timeval *timeout OPTIONAL, - IN LPOVERLAPPED lpOverlapped OPTIONAL, - IN LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine OPTIONAL, - OUT LPHANDLE lpNameHandle OPTIONAL); + _In_ PCSTR pName, + _In_opt_ PCSTR pServiceName, + _In_opt_ SOCKET_ADDRESS *pAddresses, + _In_ DWORD dwAddressCount, + _In_opt_ LPBLOB lpBlob, + _In_ DWORD dwFlags, + _In_ DWORD dwNameSpace, + _In_opt_ LPGUID lpNspId, + _In_opt_ struct timeval *timeout, + _In_opt_ LPOVERLAPPED lpOverlapped, + _In_opt_ LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine, + _Out_opt_ LPHANDLE lpNameHandle);
WINSOCK_API_LINKAGE INT WSAAPI SetAddrInfoExW( - IN PCWSTR pName, - IN PCWSTR pServiceName OPTIONAL, - IN SOCKET_ADDRESS *pAddresses OPTIONAL, - IN DWORD dwAddressCount, - IN LPBLOB lpBlob OPTIONAL, - IN DWORD dwFlags, - IN DWORD dwNameSpace, - IN LPGUID lpNspId OPTIONAL, - IN struct timeval *timeout OPTIONAL, - IN LPOVERLAPPED lpOverlapped OPTIONAL, - IN LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine OPTIONAL, - OUT LPHANDLE lpNameHandle OPTIONAL); + _In_ PCWSTR pName, + _In_opt_ PCWSTR pServiceName, + _In_opt_ SOCKET_ADDRESS *pAddresses, + _In_ DWORD dwAddressCount, + _In_opt_ LPBLOB lpBlob, + _In_ DWORD dwFlags, + _In_ DWORD dwNameSpace, + _In_opt_ LPGUID lpNspId, + _In_opt_ struct timeval *timeout, + _In_opt_ LPOVERLAPPED lpOverlapped, + _In_opt_ LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine, + _Out_opt_ LPHANDLE lpNameHandle);
#ifdef UNICODE #define SetAddrInfoEx SetAddrInfoExW @@ -241,33 +241,33 @@
typedef INT (WSAAPI *LPFN_SETADDRINFOEXA)( - IN PCSTR pName, - IN PCSTR pServiceName OPTIONAL, - IN SOCKET_ADDRESS *pAddresses OPTIONAL, - IN DWORD dwAddressCount, - IN LPBLOB lpBlob OPTIONAL, - IN DWORD dwFlags, - IN DWORD dwNameSpace, - IN LPGUID lpNspId OPTIONAL, - IN struct timeval *timeout OPTIONAL, - IN LPOVERLAPPED lpOverlapped OPTIONAL, - IN LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine OPTIONAL, - OUT LPHANDLE lpNameHandle OPTIONAL); + _In_ PCSTR pName, + _In_opt_ PCSTR pServiceName, + _In_opt_ SOCKET_ADDRESS *pAddresses, + _In_ DWORD dwAddressCount, + _In_opt_ LPBLOB lpBlob, + _In_ DWORD dwFlags, + _In_ DWORD dwNameSpace, + _In_opt_ LPGUID lpNspId, + _In_opt_ struct timeval *timeout, + _In_opt_ LPOVERLAPPED lpOverlapped, + _In_opt_ LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine, + _Out_opt_ LPHANDLE lpNameHandle);
typedef INT (WSAAPI *LPFN_SETADDRINFOEXW)( - IN PCWSTR pName, - IN PCWSTR pServiceName OPTIONAL, - IN SOCKET_ADDRESS *pAddresses OPTIONAL, - IN DWORD dwAddressCount, - IN LPBLOB lpBlob OPTIONAL, - IN DWORD dwFlags, - IN DWORD dwNameSpace, - IN LPGUID lpNspId OPTIONAL, - IN struct timeval *timeout OPTIONAL, - IN LPOVERLAPPED lpOverlapped OPTIONAL, - IN LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine OPTIONAL, - OUT LPHANDLE lpNameHandle OPTIONAL); + _In_ PCWSTR pName, + _In_opt_ PCWSTR pServiceName, + _In_opt_ SOCKET_ADDRESS *pAddresses, + _In_ DWORD dwAddressCount, + _In_opt_ LPBLOB lpBlob, + _In_ DWORD dwFlags, + _In_ DWORD dwNameSpace, + _In_opt_ LPGUID lpNspId, + _In_opt_ struct timeval *timeout, + _In_opt_ LPOVERLAPPED lpOverlapped, + _In_opt_ LPLOOKUPSERVICE_COMPLETION_ROUTINE lpCompletionRoutine, + _Out_opt_ LPHANDLE lpNameHandle);
#ifdef UNICODE #define LPFN_SETADDRINFOEX LPFN_SETADDRINFOEXW @@ -282,7 +282,7 @@ VOID WSAAPI freeaddrinfo( - IN PADDRINFOA pAddrInfo OPTIONAL); + _In_opt_ PADDRINFOA pAddrInfo);
#if (NTDDI_VERSION >= NTDDI_WINXPSP2) || (_WIN32_WINNT >= 0x0502)
@@ -290,7 +290,7 @@ VOID WSAAPI FreeAddrInfoW( - IN PADDRINFOW pAddrInfo OPTIONAL); + _In_opt_ PADDRINFOW pAddrInfo);
#define FreeAddrInfoA freeaddrinfo
@@ -305,11 +305,11 @@
typedef VOID (WSAAPI *LPFN_FREEADDRINFO)( - IN PADDRINFOA pAddrInfo OPTIONAL); + _In_opt_ PADDRINFOA pAddrInfo);
typedef VOID (WSAAPI *LPFN_FREEADDRINFOW)( - IN PADDRINFOW pAddrInfo OPTIONAL); + _In_opt_ PADDRINFOW pAddrInfo);
#define LPFN_FREEADDRINFOA LPFN_FREEADDRINFO
@@ -327,13 +327,13 @@ void WSAAPI FreeAddrInfoEx( - IN PADDRINFOEXA pAddrInfoEx OPTIONAL); + _In_opt_ PADDRINFOEXA pAddrInfoEx);
WINSOCK_API_LINKAGE void WSAAPI FreeAddrInfoExW( - IN PADDRINFOEXW pAddrInfoEx OPTIONAL); + _In_opt_ PADDRINFOEXW pAddrInfoEx);
#define FreeAddrInfoExA FreeAddrInfoEx
@@ -345,11 +345,11 @@
typedef void (WSAAPI *LPFN_FREEADDRINFOEXA)( - IN PADDRINFOEXA pAddrInfoEx); + _In_ PADDRINFOEXA pAddrInfoEx);
typedef void (WSAAPI *LPFN_FREEADDRINFOEXW)( - IN PADDRINFOEXW pAddrInfoEx); + _In_ PADDRINFOEXW pAddrInfoEx);
#ifdef UNICODE @@ -367,13 +367,13 @@ INT WSAAPI getnameinfo( - IN const SOCKADDR *pSockaddr, - IN socklen_t SockaddrLength, - OUT PCHAR pNodeBuffer OPTIONAL, - IN DWORD NodeBufferSize, - OUT PCHAR pServiceBuffer, - IN DWORD ServiceBufferSize, - IN INT Flags); + _In_reads_bytes_(SockaddrLength) const SOCKADDR *pSockaddr, + _In_ socklen_t SockaddrLength, + _Out_writes_opt_(NodeBufferSize) PCHAR pNodeBuffer, + _In_ DWORD NodeBufferSize, + _Out_writes_opt_(ServiceBufferSize) PCHAR pServiceBuffer, + _In_ DWORD ServiceBufferSize, + _In_ INT Flags);
#if (NTDDI_VERSION >= NTDDI_WINXPSP2) || (_WIN32_WINNT >= 0x0502)
@@ -381,13 +381,13 @@ INT WSAAPI GetNameInfoW( - IN const SOCKADDR *pSockaddr, - IN socklen_t SockaddrLength, - OUT PWCHAR pNodeBuffer, - IN DWORD NodeBufferSize, - OUT PWCHAR pServiceBuffer OPTIONAL, - IN DWORD ServiceBufferSize, - IN INT Flags); + _In_reads_bytes_(SockaddrLength) const SOCKADDR *pSockaddr, + _In_ socklen_t SockaddrLength, + _Out_writes_opt_(NodeBufferSize) PWCHAR pNodeBuffer, + _In_ DWORD NodeBufferSize, + _Out_writes_opt_(ServiceBufferSize) PWCHAR pServiceBuffer, + _In_ DWORD ServiceBufferSize, + _In_ INT Flags);
#define GetNameInfoA getnameinfo
@@ -403,23 +403,23 @@
typedef int (WSAAPI *LPFN_GETNAMEINFO)( - IN const SOCKADDR *pSockaddr, - IN socklen_t SockaddrLength, - OUT PCHAR pNodeBuffer, - IN DWORD NodeBufferSize, - OUT PCHAR pServiceBuffer OPTIONAL, - IN DWORD ServiceBufferSize, - IN INT Flags); + _In_reads_bytes_(SockaddrLength) const SOCKADDR *pSockaddr, + _In_ socklen_t SockaddrLength, + _Out_writes_opt_(NodeBufferSize) PCHAR pNodeBuffer, + _In_ DWORD NodeBufferSize, + _Out_writes_opt_(ServiceBufferSize) PCHAR pServiceBuffer, + _In_ DWORD ServiceBufferSize, + _In_ INT Flags);
typedef INT (WSAAPI *LPFN_GETNAMEINFOW)( - IN const SOCKADDR *pSockaddr, - IN socklen_t SockaddrLength, - OUT PWCHAR pNodeBuffer, - IN DWORD NodeBufferSize, - OUT PWCHAR pServiceBuffer OPTIONAL, - IN DWORD ServiceBufferSize, - IN INT Flags); + _In_reads_bytes_(SockaddrLength) const SOCKADDR *pSockaddr, + _In_ socklen_t SockaddrLength, + _Out_writes_opt_(NodeBufferSize) PWCHAR pNodeBuffer, + _In_ DWORD NodeBufferSize, + _Out_writes_opt_(ServiceBufferSize) PWCHAR pServiceBuffer, + _In_ DWORD ServiceBufferSize, + _In_ INT Flags);
#define LPFN_GETNAMEINFOA LPFN_GETNAMEINFO
@@ -436,32 +436,32 @@ INT WSAAPI inet_pton( - IN INT Family, - IN PCSTR pszAddrString, - OUT PVOID pAddrBuf); + _In_ INT Family, + _In_ PCSTR pszAddrString, + _Out_writes_bytes_(sizeof(IN6_ADDR)) PVOID pAddrBuf);
INT WSAAPI InetPtonW( - IN INT Family, - IN PCWSTR pszAddrString, - OUT PVOID pAddrBuf); + _In_ INT Family, + _In_ PCWSTR pszAddrString, + _Out_writes_bytes_(sizeof(IN6_ADDR)) PVOID pAddrBuf);
PCSTR WSAAPI inet_ntop( - IN INT Family, - IN PVOID pAddr, - OUT PSTR pStringBuf, - IN size_t StringBufSize); + _In_ INT Family, + _In_ PVOID pAddr, + _Out_writes_(StringBufSize) PSTR pStringBuf, + _In_ size_t StringBufSize);
PCWSTR WSAAPI InetNtopW( - IN INT Family, - IN PVOID pAddr, - OUT PWSTR pStringBuf, - IN size_t StringBufSize); + _In_ INT Family, + _In_ PVOID pAddr, + _Out_writes_(StringBufSize) PWSTR pStringBuf, + _In_ size_t StringBufSize);
#define InetPtonA inet_pton #define InetNtopA inet_ntop @@ -478,29 +478,29 @@
typedef INT (WSAAPI *LPFN_INET_PTONA)( - IN INT Family, - IN PCSTR pszAddrString, - OUT PVOID pAddrBuf); + _In_ INT Family, + _In_ PCSTR pszAddrString, + _Out_writes_bytes_(sizeof(IN6_ADDR)) PVOID pAddrBuf);
typedef INT (WSAAPI *LPFN_INET_PTONW)( - IN INT Family, - IN PCWSTR pszAddrString, - OUT PVOID pAddrBuf); + _In_ INT Family, + _In_ PCWSTR pszAddrString, + _Out_writes_bytes_(sizeof(IN6_ADDR)) PVOID pAddrBuf);
typedef PCSTR (WSAAPI *LPFN_INET_NTOPA)( - IN INT Family, - IN PVOID pAddr, - OUT PSTR pStringBuf, - IN size_t StringBufSize); + _In_ INT Family, + _In_ PVOID pAddr, + _Out_writes_(StringBufSize) PSTR pStringBuf, + _In_ size_t StringBufSize);
typedef PCWSTR (WSAAPI *LPFN_INET_NTOPW)( - IN INT Family, - IN PVOID pAddr, - OUT PWSTR pStringBuf, - IN size_t StringBufSize); + _In_ INT Family, + _In_ PVOID pAddr, + _Out_writes_(StringBufSize) PWSTR pStringBuf, + _In_ size_t StringBufSize);
#ifdef UNICODE #define LPFN_INET_PTON LPFN_INET_PTONW @@ -526,7 +526,7 @@ static __inline char * gai_strerrorA( - IN int ecode) + _In_ int ecode) { static char buff[GAI_STRERROR_BUFFER_SIZE + 1];
@@ -546,7 +546,7 @@ static __inline WCHAR * gai_strerrorW( - IN int ecode) + _In_ int ecode) { static WCHAR buff[GAI_STRERROR_BUFFER_SIZE + 1];
@@ -568,12 +568,12 @@ WS2TCPIP_INLINE int setipv4sourcefilter( - IN SOCKET Socket, - IN IN_ADDR Interface, - IN IN_ADDR Group, - IN MULTICAST_MODE_TYPE FilterMode, - IN ULONG SourceCount, - IN CONST IN_ADDR *SourceList) + _In_ SOCKET Socket, + _In_ IN_ADDR Interface, + _In_ IN_ADDR Group, + _In_ MULTICAST_MODE_TYPE FilterMode, + _In_ ULONG SourceCount, + _In_reads_(SourceCount) CONST IN_ADDR *SourceList) { int Error; DWORD Size, Returned; @@ -609,15 +609,16 @@ return Error; }
+_Success_(return == 0) WS2TCPIP_INLINE int getipv4sourcefilter( - IN SOCKET Socket, - IN IN_ADDR Interface, - IN IN_ADDR Group, - OUT MULTICAST_MODE_TYPE *FilterMode, - IN OUT ULONG *SourceCount, - OUT IN_ADDR *SourceList) + _In_ SOCKET Socket, + _In_ IN_ADDR Interface, + _In_ IN_ADDR Group, + _Out_ MULTICAST_MODE_TYPE *FilterMode, + _Inout_ ULONG *SourceCount, + _Out_writes_(*SourceCount) IN_ADDR *SourceList) { int Error; DWORD Size, Returned; @@ -662,13 +663,13 @@ WS2TCPIP_INLINE int setsourcefilter( - IN SOCKET Socket, - IN ULONG Interface, - IN CONST SOCKADDR *Group, - IN int GroupLength, - IN MULTICAST_MODE_TYPE FilterMode, - IN ULONG SourceCount, - IN CONST SOCKADDR_STORAGE *SourceList) + _In_ SOCKET Socket, + _In_ ULONG Interface, + _In_ CONST SOCKADDR *Group, + _In_ int GroupLength, + _In_ MULTICAST_MODE_TYPE FilterMode, + _In_ ULONG SourceCount, + _In_reads_(SourceCount) CONST SOCKADDR_STORAGE *SourceList) { int Error; DWORD Size, Returned; @@ -701,16 +702,17 @@ return Error; }
+_Success_(return == 0) WS2TCPIP_INLINE int getsourcefilter( - IN SOCKET Socket, - IN ULONG Interface, - IN CONST SOCKADDR *Group, - IN int GroupLength, - OUT MULTICAST_MODE_TYPE *FilterMode, - IN OUT ULONG *SourceCount, - OUT SOCKADDR_STORAGE *SourceList) + _In_ SOCKET Socket, + _In_ ULONG Interface, + _In_ CONST SOCKADDR *Group, + _In_ int GroupLength, + _Out_ MULTICAST_MODE_TYPE *FilterMode, + _Inout_ ULONG *SourceCount, + _Out_writes_(*SourceCount) SOCKADDR_STORAGE *SourceList) { int Error; DWORD Size, Returned; @@ -753,8 +755,8 @@ WS2TCPIP_INLINE int idealsendbacklogquery( - IN SOCKET s, - OUT ULONG *pISB) + _In_ SOCKET s, + _Out_ ULONG *pISB) { DWORD bytes;
@@ -765,9 +767,9 @@ WS2TCPIP_INLINE int idealsendbacklognotify( - IN SOCKET s, - IN LPWSAOVERLAPPED lpOverlapped OPTIONAL, - IN LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine OPTIONAL) + _In_ SOCKET s, + _In_opt_ LPWSAOVERLAPPED lpOverlapped, + _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine) { DWORD bytes;
@@ -786,51 +788,51 @@ INT WSAAPI WSASetSocketSecurity( - IN SOCKET Socket, - IN const SOCKET_SECURITY_SETTINGS *SecuritySettings OPTIONAL, - IN ULONG SecuritySettingsLen, - IN LPWSAOVERLAPPED Overlapped OPTIONAL, - IN LPWSAOVERLAPPED_COMPLETION_ROUTINE CompletionRoutine OPTIONAL); + _In_ SOCKET Socket, + _In_reads_bytes_opt_(SecuritySettingsLen) const SOCKET_SECURITY_SETTINGS *SecuritySettings, + _In_ ULONG SecuritySettingsLen, + _In_opt_ LPWSAOVERLAPPED Overlapped, + _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE CompletionRoutine);
WINSOCK_API_LINKAGE INT WSAAPI WSAQuerySocketSecurity( - IN SOCKET Socket, - IN const SOCKET_SECURITY_QUERY_TEMPLATE *SecurityQueryTemplate OPTIONAL, - IN ULONG SecurityQueryTemplateLen, - OUT SOCKET_SECURITY_QUERY_INFO* SecurityQueryInfo OPTIONAL, - IN OUT ULONG *SecurityQueryInfoLen, - IN LPWSAOVERLAPPED Overlapped OPTIONAL, - IN LPWSAOVERLAPPED_COMPLETION_ROUTINE CompletionRoutine OPTIONAL); + _In_ SOCKET Socket, + _In_reads_bytes_opt_(SecurityQueryTemplateLen) const SOCKET_SECURITY_QUERY_TEMPLATE *SecurityQueryTemplate, + _In_ ULONG SecurityQueryTemplateLen, + _Out_writes_bytes_to_opt_(*SecurityQueryInfoLen, *SecurityQueryInfoLen) SOCKET_SECURITY_QUERY_INFO* SecurityQueryInfo, + _Inout_ ULONG *SecurityQueryInfoLen, + _In_opt_ LPWSAOVERLAPPED Overlapped, + _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE CompletionRoutine);
WINSOCK_API_LINKAGE INT WSAAPI WSASetSocketPeerTargetName( - IN SOCKET Socket, - IN const SOCKET_PEER_TARGET_NAME *PeerTargetName, - IN ULONG PeerTargetNameLen, - IN LPWSAOVERLAPPED Overlapped OPTIONAL, - IN LPWSAOVERLAPPED_COMPLETION_ROUTINE CompletionRoutine OPTIONAL); + _In_ SOCKET Socket, + _In_reads_bytes_(PeerTargetNameLen) const SOCKET_PEER_TARGET_NAME *PeerTargetName, + _In_ ULONG PeerTargetNameLen, + _In_opt_ LPWSAOVERLAPPED Overlapped, + _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE CompletionRoutine);
WINSOCK_API_LINKAGE INT WSAAPI WSADeleteSocketPeerTargetName( - IN SOCKET Socket, - IN const struct sockaddr *PeerAddr, - IN ULONG PeerAddrLen, - IN LPWSAOVERLAPPED Overlapped OPTIONAL, - IN LPWSAOVERLAPPED_COMPLETION_ROUTINE CompletionRoutine OPTIONAL); + _In_ SOCKET Socket, + _In_reads_bytes_(PeerAddrLen) const struct sockaddr *PeerAddr, + _In_ ULONG PeerAddrLen, + _In_opt_ LPWSAOVERLAPPED Overlapped, + _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE CompletionRoutine);
WINSOCK_API_LINKAGE INT WSAAPI WSAImpersonateSocketPeer( - IN SOCKET Socket, - IN const struct sockaddr *PeerAddr OPTIONAL, - IN ULONG PeerAddrLen); + _In_ SOCKET Socket, + _In_reads_bytes_opt_(PeerAddrLen) const struct sockaddr *PeerAddr, + _In_ ULONG PeerAddrLen);
WINSOCK_API_LINKAGE INT