WSAGetQOSByName 함수(winsock2.h)

아티클
03/09/2024

WSAGetQOSByName 함수는 명명된 템플릿을 기반으로 QOS 구조를 초기화하거나 사용 가능한 템플릿 이름의 열거형을 검색하는 버퍼를 제공합니다.

구문

BOOL WSAAPI WSAGetQOSByName(
  [in]      SOCKET   s,
  [in, out] LPWSABUF lpQOSName,
  [out]     LPQOS    lpQOS
);

매개 변수

[in] s

소켓을 식별하는 설명자입니다.

[in, out] lpQOSName

특정 서비스 품질 템플릿에 대한 포인터입니다.

[out] lpQOS

채울 QOS 구조체에 대한 포인터입니다.

반환 값

WSAGetQOSByName이 성공하면 반환 값은 TRUE입니다. 함수가 실패하면 반환 값은 FALSE입니다. 확장된 오류 정보를 얻으려면 WSAGetLastError를 호출합니다.

오류 코드	의미
WSANOTINITIALISED	이 함수를 사용하기 전에 성공적인 WSAStartup 호출이 발생해야 합니다.
WSAENETDOWN	네트워크 하위 시스템이 실패했습니다.
WSAENOTSOCK	설명자가 소켓이 아닙니다.
WSAEFAULT	lpQOSName 또는 lpQOS 매개 변수가 사용자 주소 공간의 유효한 부분이 아니거나 lpQOS의 버퍼 길이가 너무 작습니다.

설명

WSAGetQOSByName 함수는 애플리케이션에서 QOS 구조를 특정 서비스 클래스 또는 미디어 형식에 적합한 알려진 값 집합으로 초기화하는 데 사용됩니다. 이러한 값은 잘 알려진 이름으로 참조되는 템플릿에 저장됩니다. 클라이언트는 템플릿 이름을 지정하는 0이 아닌 길이 문자열을 가리키는 lpQOSName으로 표시된 WSABUF 구조체의 buf 매개 변수를 설정하여 이러한 값을 검색할 수 있습니다. 이 경우 lpQOSName 사용은 IN이며 결과는 lpQOS를 통해 반환됩니다.

또는 클라이언트는 이 함수를 사용하여 사용 가능한 템플릿 이름의 열거형을 검색할 수 있습니다. 클라이언트는 lpQOSName으로 표시된 WSABUF의 buf 매개 변수를 길이가 0인 null로 끝나는 문자열로 설정하여 이 작업을 수행할 수 있습니다. 이 경우 buf로 표시된 버퍼는 lpQOSName으로 표시된 WSABUF의 len 매개 변수에 표시된 대로 buf에서 사용할 수 있는 바이트 수까지 사용 가능한 null로 끝나는 템플릿 이름의 시퀀스로 덮어씁니다. 이름 목록 자체는 길이가 0인 이름으로 종료됩니다. WSAGetQOSByName 함수를 사용하여 템플릿 이름을 검색하면 lpQOS 매개 변수가 무시됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winsock2.h
라이브러리	Ws2_32.lib
DLL	Ws2_32.dll