* Annotate ws2tcpip.h.

svn path=/trunk/; revision=59743
This commit is contained in:
Amine Khaldi 2013-08-15 12:59:02 +00:00
parent cf07d17423
commit 7f9ea4491b

View file

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