네트워크 관리 함수 버퍼 길이

이 항목에서는 네트워크 관리 API와 함께 사용할 때 함수 버퍼 길이에 대한 요구 사항에 대해 설명합니다.

네트워크 관리 열거형 함수(및 다양한 데이터 검색 함수)를 호출할 때 버퍼 크기를 지정하는 애플리케이션은 반환된 정보 구조(또는 구조체)와 멤버가 가리키는 문자열을 저장할 수 있을 만큼 큰 버퍼를 지정해야 합니다. 사용 가능한 모든 항목을 받을 수 있을 만큼 큰 버퍼를 지정하지 않으면 함수는 ERROR_MORE_DATA 반환합니다. 열거형 호출은 부분 항목을 반환하지 않습니다.

일부 네트워크 관리 함수는 권고 최대 데이터 길이 매개 변수인 prefmaxlen을 사용합니다. 이 매개 변수를 사용하면 애플리케이션에서 서버가 함수 호출에서 반환해야 하는 바이트 수를 제안할 수 있습니다.

prefmaxlen 매개 변수에 MAX_PREFERRED_LENGTH 값을 지정하는 경우 네트워크 관리 함수는 데이터에 필요한 메모리 양을 할당합니다.

자세한 내용은 네트워크 관리 함수 버퍼를 참조하세요.