WSAGetQOSByName
The Windows
Sockets WSAGetQOSByName function initializes a QOS structure based on a
named template.
BOOL WSAGetQOSByName(
|
SOCKET s, |
|
|
LPWSABUF lpQOSName, |
|
|
LPQOS lpQOS |
|
|
); |
|
Parameters
s
[in] A
descriptor identifying a socket.
lpQOSName
[in]
Specifies the QOS template name.
lpQOS
[out] A
pointer to the QOS structure to be filled.
Remarks
Applications
may use this function to initalize a QOS structure to a set of known values
appropriate for a particular service class or media type. These values are
stored in a template which is referenced by a well-known name.
Return Values
If the
function succeeds, the return value is TRUE. If the function fails, the return
value is FALSE. To get extended error information, call WSAGetLastError.
Error Codes
|
WSANOTINITIALISED |
A
successful WSAStartup must occur before using this function. |
|
WSAENETDOWN |
The network
subsystem has failed. |
|
WSAENOTSOCK |
The
descriptor is not a socket. |
|
WSAEFAULT |
The lpQOS
argument is not a valid part of the user address space, or the buffer
length for lpQOS is too small. |
|
WSA_INVAL |
The
specified QOS template name is invalid. |
See Also