Buffers de função de gerenciamento de rede

A biblioteca de tempo de execução RPC lida com os buffers exigidos pelas funções de gerenciamento de rede de recuperação de dados de 32 bits da seguinte maneira:

• Envio de dados para o servidor (dados especificados pelos parâmetros [in]).

  O chamador deve alocar e desalocar o buffer para a estrutura (ou estruturas) de informação relevante e passar uma variável de ponteiro para a função. O chamador não precisa especificar o comprimento do buffer.

  Exemplo: NetGroupAdd

• Recuperando dados do servidor (dados especificados por parâmetros [out]).

  O sistema aloca o buffer para as informações retornadas. O chamador deve passar uma variável de ponteiro para a função na entrada. No retorno bem-sucedido, o ponteiro recebe o endereço do buffer alocado pelo sistema que contém as informações retornadas. Isso simplifica o código de chamada, porque o chamador não precisa estimar o tamanho do buffer ou redimensionar o buffer e reemitir a função.

  Quando o chamador terminar de processar as informações retornadas, ele deve liberar a memória alocada pelo sistema chamando a funçãoNetApiBufferFree. Para obter mais informações sobre como especificar tamanhos de buffer, consulte Network Management Function Buffer Lengths.

  Exemplo: NetGroupEnum