Partager via


Fonction de rappel PFNRASGETBUFFER (ras.h)

La DLL de script personnalisé appelle RasGetBuffer pour allouer de la mémoire à l’envoi ou à la réception de données sur le port connecté au serveur.

Syntaxe

PFNRASGETBUFFER Pfnrasgetbuffer;

DWORD Pfnrasgetbuffer(
  PBYTE *ppBuffer,
  PDWORD pdwSize
)
{...}

Paramètres

ppBuffer

Pointeur vers un pointeur qui reçoit l’adresse de la mémoire tampon retournée.

pdwSize

Pointeur vers une variable DWORD qui, lors de l’entrée, contient la taille demandée de la mémoire tampon. En sortie, cette variable contient la taille réelle de la mémoire tampon allouée.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est le code d’erreur suivant.

Valeur Signification
ERROR_OUT_OF_BUFFERS
RAS ne peut plus allouer d’espace de mémoire tampon.

Notes

La taille maximale de la mémoire tampon qui peut être obtenue est de 1 500 octets.

La DLL de script personnalisé appelle RasGetBuffer via un pointeur de fonction. Le pointeur de fonction est passé à la DLL de script personnalisé en tant que paramètre lorsque RAS appelle l’implémentation de la DLL de RasCustomScriptExecute.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête ras.h

Voir aussi

Script personnalisé RAS

RasCustomScriptExecute

RasFreeBuffer