Comprimentos de buffer da função de gerenciamento de rede

Este tópico discute os requisitos para comprimentos de buffer de função quando usados com as APIs de gerenciamento de rede.

Os aplicativos que especificam tamanhos de buffer ao chamar funções de enumeração de gerenciamento de rede (e várias funções de recuperação de dados) devem especificar buffers grandes o suficiente para conter a estrutura (ou estruturas) de informações retornadas mais as cadeias de caracteres para as quais seus membros apontam. Se você não especificar um buffer grande o suficiente para receber todas as entradas disponíveis, a função retornará ERROR_MORE_DATA. As chamadas de enumeração não retornam entradas parciais.

Algumas funções de gerenciamento de rede usam um parâmetro consultivo de comprimento máximo de dados, prefmaxlen. Esse parâmetro permite que um aplicativo sugira o número de bytes que o servidor deve retornar de uma chamada de função.

Se você especificar o valor MAX_PREFERRED_LENGTH no parâmetro prefmaxlen, as funções de gerenciamento de rede alocarão a quantidade de memória necessária para os dados.

Para obter mais informações, consulte Network Management Function Buffers.