Długość buforu funkcji zarządzania siecią

W tym temacie omówiono wymagania dotyczące długości buforu funkcji w przypadku użycia z interfejsami API zarządzania siecią.

Aplikacje określające rozmiary buforu podczas wywoływania funkcji wyliczania zarządzania siecią (i różnych funkcji pobierania danych) muszą określać wystarczająco duże, aby przechowywać zwracaną strukturę informacji (lub struktury) oraz ciągi, do których wskazują ich elementy członkowskie. Jeśli nie określisz wystarczająco dużego buforu, aby odebrać wszystkie dostępne wpisy, funkcja zwróci ERROR_MORE_DATA. Wywołania wyliczenia nie zwracają częściowych wpisów.

Niektóre funkcje zarządzania siecią przyjmują parametr maksymalnej długości danych, prefmaxlen. Ten parametr umożliwia aplikacji sugerowanie liczby bajtów, które serwer powinien zwrócić z wywołania funkcji.

Jeśli określisz wartość MAX_PREFERRED_LENGTH w parametrze prefmaxlen, funkcje zarządzania siecią przydzielają ilość pamięci wymaganej dla danych.

Aby uzyskać więcej informacji, zobacz funkcji zarządzania siecią.