IGlobalRSCAQueryProvider::GetOutputBuffer-Methode

Artikel
07/19/2023

Erstellt ein neues BYTE Array.

Syntax

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

Parameter

cbBuffer
[IN] Ein DWORD , der die Anzahl der zuzuordnenden Bytes enthält.

ppbBuffer
[OUT] Ein Zeiger auf ein BYTE Array, das den neuen Puffer enthält.

Rückgabewert

HRESULT. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Wert	Definition
S_OK	Gibt an, dass der Vorgang erfolgreich war.
E_OUTOFMEMORY	Gibt an, dass der Heapspeicher erschöpft ist.

Bemerkungen

Von CGlobalModule abgeleitete Klassen, die sich für GL_RSCA_QUERY Ereignisse registrieren, erhalten einen IGlobalRscaQueryProvider-Zeiger als Parameter für die CGlobalModule::OnGlobalRSCAQuery-Methodevirtual . Sie können dann ein neues BYTE Array abrufen, indem Sie die GetOutputBuffer -Methode für den IGlobalRSCAQueryProvider Zeiger aufrufen.

Der GetOutputBuffer Rückgabewert hängt von der Implementierung ab. Sie sollten die folgenden Informationen als Richtlinie verwenden, aber sie sind möglicherweise nicht in allen Szenarien korrekt:

Der IGlobalRSCAQueryProvider Implementierer deklariert einen privaten BYTE Zeiger als Membervariable namens buffer. Der Implementierer initialisiert buffer beim Erstellen auf NULL. Wenn buffer nicht NULL ist, wenn GetOutputBuffer aufgerufen wird, wird die LocalFree-Funktion für bufferaufgerufen. Die LocalAlloc-Funktion wird aufgerufen, um einem neuen BYTE Array der Größe cbBuffer auf dem Heap zuzuweisenbuffer. buffer wird dann im dereferenzierten ppbBuffer Parameter zurückgegeben, wenn GetOutputBuffer S_OK zurückgegeben wird.

Wichtig Diese Methode ist Teil der IIS 7-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Hinweise für Implementierer

IGlobalRSCAQueryProvider-Implementierer sind für die Speicherverwaltung mit diesen Daten verantwortlich; Daher müssen Implementierer, die die dynamische Speicherbelegung verwenden, IGlobalRSCAQueryProvider den BYTE Zeiger freigeben oder aufrufendelete, wenn er nicht mehr benötigt wird.

Hinweise für Aufrufer

IGlobalRSCAQueryProvider -Implementierer sind für die Speicherverwaltung mit diesen Daten verantwortlich; IGlobalRSCAQueryProvider Aus diesem Grund dürfen Clients das Löschen für den zurückgegebenen BYTE Zeiger nicht freigeben oder aufrufen, wenn diese Daten nicht mehr benötigt werden.

Anforderungen

type	BESCHREIBUNG
Client	– IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 unter Windows 8 – IIS 10.0 unter Windows 10
Server	– IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 unter Windows Server 2012 – IIS 8.5 unter Windows Server 2012 R2 – IIS 10.0 unter Windows Server 2016
Produkt	– IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header	Httpserv.h

Weitere Informationen

IGlobalRSCAQueryProvider-Schnittstelle
IGlobalRSCAQueryProvider::ResizeOutputBuffer-Methode

Freigeben über