Lunghezze del buffer delle funzioni di gestione di rete

Questo argomento illustra i requisiti per le lunghezze del buffer delle funzioni quando vengono usate con le API di gestione di rete.

Le applicazioni che specificano le dimensioni del buffer quando si chiamano funzioni di enumerazione di gestione di rete (e varie funzioni di recupero dati) devono specificare buffer sufficientemente grandi per contenere la struttura di informazioni restituita (o le strutture) più le stringhe a cui puntano i membri. Se non si specifica un buffer sufficientemente grande per ricevere tutte le voci disponibili, la funzione restituisce ERROR_MORE_DATA. Le chiamate di enumerazione non restituiscono voci parziali.

Alcune funzioni di gestione di rete accettano un parametro di lunghezza massima dei dati consultiva, prefmaxlen. Questo parametro consente a un'applicazione di suggerire il numero di byte che il server deve restituire da una chiamata di funzione.

Se si specifica il valore MAX_PREFERRED_LENGTH nel parametro prefmaxlen, le funzioni di gestione di rete allocano la quantità di memoria necessaria per i dati.

Per altre informazioni, vedere Buffer delle funzioni di gestione di rete.