Mémoires tampons de fonction de gestion du réseau

La bibliothèque d’exécution RPC gère les mémoires tampons requises par les fonctions de gestion réseau de récupération de données 32 bits comme suit :

  • Envoi de données au serveur (données spécifiées par les paramètres [in]).

    L’appelant doit allouer et libérer la mémoire tampon pour la ou les structures d’informations pertinentes et passer une variable pointeur à la fonction. L’appelant n’a pas besoin de spécifier la longueur de la mémoire tampon.

    Exemple : NetGroupAdd

  • Récupération de données à partir du serveur (données spécifiées par les paramètres [out]).

    Le système alloue la mémoire tampon pour les informations retournées. L’appelant doit passer une variable pointeur à la fonction lors de l’entrée. En cas de retour réussi, le pointeur reçoit l’adresse de la mémoire tampon allouée par le système qui contient les informations retournées. Cela simplifie le code appelant, car l’appelant n’a pas besoin d’estimer la taille de la mémoire tampon, ni de redimensionner la mémoire tampon et de réémettre la fonction.

    Lorsque l’appelant a terminé de traiter les informations retournées, il doit libérer la mémoire allouée par le système en appelant la fonction NetApiBufferFree . Pour plus d’informations sur la spécification des tailles de mémoire tampon, consultez Longueurs des mémoires tampons des fonctions de gestion réseau.

    Exemple : NetGroupEnum