IGlobalRSCAQueryProvider::GetOutputBuffer, méthode

Crée un tableau BYTE .

Syntaxe

virtual HRESULT GetOutputBuffer(  
   DWORD cbBuffer,  
   OUT BYTE** ppbBuffer  
) = 0;  

Paramètres

cbBuffer
[IN] DWORD qui contient le nombre d’octets à allouer.

ppbBuffer
[OUT] Pointeur vers un BYTE tableau qui contient la nouvelle mémoire tampon.

Valeur renvoyée

Élément HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Remarques

Les classes dérivées de CGlobalModule qui s’inscrivent à des événements GL_RSCA_QUERY reçoivent un pointeur IGlobalRscaQueryProvider en tant que paramètre sur la méthode CGlobalModule::OnGlobalRSCAQueryvirtual. Vous pouvez ensuite récupérer un nouveau BYTE tableau en appelant la GetOutputBuffer méthode sur le IGlobalRSCAQueryProvider pointeur.

La GetOutputBuffer valeur de retour dépend de l’implémentation. Vous devez utiliser les informations suivantes comme ligne directrice, mais elles peuvent ne pas être correctes dans tous les scénarios :

L’implémenteur IGlobalRSCAQueryProvider déclare un pointeur privé BYTE en tant que variable membre appelée buffer; l’implémenteur s’initialise buffer sur NULL au moment de la construction. Si buffer n’a pas la valeur NULL quand GetOutputBuffer est appelé, la fonction LocalFree est appelée sur buffer. La fonction LocalAlloc est appelée à affecter buffer à un nouveau BYTE tableau de taille cbBuffer sur le tas. buffer est ensuite retourné dans le paramètre déréférencement si ppbBufferGetOutputBuffer retourne S_OK.

Important Cette méthode fait partie de l’infrastructure IIS 7 et n’est pas destinée à être utilisée directement à partir de votre code.

Remarques pour les implémenteurs

IGlobalRSCAQueryProvider les implémenteurs sont responsables de la gestion de la mémoire avec ces données ; par conséquent, IGlobalRSCAQueryProvider les implémenteurs qui utilisent l’allocation de mémoire dynamique doivent libérer ou appeler delete le BYTE pointeur lorsqu’il n’est plus nécessaire.

Remarques pour les appelants

IGlobalRSCAQueryProvider les implémenteurs sont responsables de la gestion de la mémoire avec ces données ; par conséquent, IGlobalRSCAQueryProvider les clients ne doivent pas libérer ou appeler la suppression sur le pointeur retourné BYTE lorsque ces données ne sont plus nécessaires.

Spécifications

Voir aussi

IGlobalRSCAQueryProvider, interface
IGlobalRSCAQueryProvider::ResizeOutputBuffer, méthode