Compartilhar via


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

Este tópico discute os requisitos de comprimentos de buffer de função quando usado 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 manter a estrutura de informações (ou estruturas) retornadas mais as cadeias de caracteres às 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 recebem um parâmetro de comprimento de dados máximo de consultoria, 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 Buffers de função de gerenciamento de rede.