WSAEnumProtocols
WSAEnumProtocols 함수는 사용가능한 트랜스포트 계층의 프로토콜에 대한 정보를 반환하는 함수입니다.
int WSAEnumProtocols (
LPINT lpiProtocols,
LPWSAPROTOCOL_INFO lpProtocolBuffer,
ILPDWORD lpdwBufferLength
);
Parameters
lpiProtocols
[입력] NULL로 끝나는 프로토콜
값의 배열입니다. 이 매개변수는 부가적으로 사용되는 값이죠. 만약 lpiProtocols
매개변수가 NULL 이라면, 모든 사용가능한 프로토콜들의 정보가 반환되게 됩니다.
NULL이 아니라면, 단지 이 어레이에 지정된 프로토콜에 대한 정보만이 반환됩니다.
lpProtocolBuffer
[출력] WSAPROTOCOL_INFO
구조체로 프로토콜 정보를 채울 버퍼
lpdwBufferLength
[입력/출력] 이 매개변수가
입력용으로 사용될 경우 WSAEnumProtocols
함수에 넘기는 lpProtocolBuffer 버퍼에 대한 바이트의 갯수를 넘깁니다.
출력용으로 사용될 경우는 모든 요청된 정보를 반환하기 위하여 WSAEnumProtocols
함수에 넘길 수 있는 최소버퍼 크기를 나타냅니다.
Remarks
WSAEnumProtocols 함수는 트랜스포트 계층 프로토콜과 로컬에 설치된 프로토콜 체인에 대한 정보를 얻어내는데 사용하는 함수입니다. 계층적 프로토콜은 프로토콜 체인이 설치되었을 때만 어플레케이션에서 사용할 수 있기 때문에, 계층적 프로토콜 정보는 lpProtocolBuffer 에 포함되지 않습니다.
WSAPROTOCOL_INFO는 각각의 요청된 프로토콜에 대해서 프로토콜 정보를 담을 구조체입니다. 만약 이 버퍼가 모든 정보를 담기에 충분하지 못하다면, lpdwBufferLength 매개변수는 필요한 버퍼의 크기로 업데이트 될 것입니다. 어플리케이션은 이 크기를 확인하고, 모든 정보를 담기에 충분한 버퍼를 다시 마련하여 WSAEnumProtocols 함수를 다시 호출할 수 있습니다.
Return Values
함수가 성공적으로 수행된다면, 함수는 얻어낸 프로토콜의 갯수를 반환 할 것입니다. 에러가 발생한 경우는, SOCKET_ERROR 가 반환되고, WSAGetLastError 함수를 호출하여 특정한 에러코드를 얻어낼 수 있습니다.
Error Codes
| WSANOTINITIALISED | 이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다. |
| WSAENETDOWN | 네트웍 서브시스템에 에러가 발생했습니다. |
| WSAEINPROGRESS | 블록킹 윈속1.1 이 현재 처리주에 있습니다. |
| WSAEINVAL | 지정된 매개변수중 하나가 잘못된 값입니다. |
| WSAENOBUFS | 지정된 버퍼 길이가 모든 관련된 WSAPROTOCOL_INFO구조체와 정보를 담기에 너무 작습니다. 넘겨주는 버퍼는 최소한 lpdwBufferLength로 반환된 값보다 커야 합니다. |
| WSAEFAULT | lpiProtocols, lpProtocolBuffer, lpdwBufferLength 매개변수중에 잘못된 어드레스를 가리키는 공간이 있습니다. |
QuickInfo
Windows NT : 사용가능
Windows
: 사용가능
Windows CE
:
지원하지 않음
Header
:
Win32
: winsock.h
Win32-II
: winsock2.h
Import Library :
Win32
: wsock32.lib
Win32-II
: ws2_32.lib
See Also