Compartilhar via


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