Buffers de função de gerenciamento de rede

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

• Enviar dados para o servidor (dados especificados por parâmetros [in]).

  O chamador deve alocar e desalocar o buffer para a estrutura de informações relevante (ou estruturas) 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, pois o chamador não precisa estimar o tamanho do buffer ou redimensionar o buffer e reemissar a função.

  Quando o chamador terminar de processar as informações retornadas, ele deverá liberar a memória alocada pelo sistema chamando a função NetApiBufferFree . Para obter mais informações sobre como especificar tamanhos de buffer, consulte Comprimentos do buffer de função de gerenciamento de rede.

  Exemplo: NetGroupEnum