다음을 통해 공유

LPWSPGETQOSBYNAME 콜백 함수(ws2spi.h)

  • 아티클

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

구문

LPWSPGETQOSBYNAME Lpwspgetqosbyname;

BOOL Lpwspgetqosbyname(
  [in]      SOCKET s,
  [in, out] LPWSABUF lpQOSName,
  [out]     LPQOS lpQOS,
  [out]     LPINT lpErrno
)
{...}

매개 변수

[in] s

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

[in, out] lpQOSName

QOS 템플릿 이름을 지정하거나 사용 가능한 템플릿 이름의 열거형을 검색하는 버퍼를 제공합니다.

[out] lpQOS

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

[out] lpErrno

오류 코드에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다. 함수가 실패하면 반환 값은 FALSE이고 특정 오류 코드는 lpErrno에서 사용할 수 있습니다.

오류 코드 의미
WSAENETDOWN
 네트워크 하위 시스템이 실패했습니다.
WSAENOTSOCK
 설명자가 소켓이 아닙니다.
WSAENOTSOCK
 lpQOS 인수가 사용자 주소 공간의 유효한 부분이 아니거나 lpQOS의 버퍼 길이가 너무 작습니다.
WSAEINVAL
 지정된 QOS 템플릿 이름이 잘못되었습니다.

설명

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

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 ws2spi.h

추가 정보

LPWSPAccept

LPWSPConnect

LPWSPGetSockopt