IGlobalRSCAQueryProvider：：GetOutputBuffer 方法

建立新的 BYTE 陣列。

語法

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

參數

cbBuffer
[IN] DWORD ，其中包含要配置的位元組數目。

ppbBuffer
[OUT]包含新緩衝區之陣列的指標 BYTE 。

傳回值

HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

值	定義
S_OK	表示作業成功。
E_OUTOFMEMORY	表示堆積記憶體已耗盡。

備註

註冊GL_RSCA_QUERY事件的CGlobalModule衍生類別會收到IGlobalRscaQueryProvider指標做為CGlobalModule：：OnGlobalRSCAQueryvirtual 方法上的參數。 接著，您可以在指標上 IGlobalRSCAQueryProvider 呼叫 GetOutputBuffer 方法，以擷取新的 BYTE 陣列。

傳 GetOutputBuffer 回值取決於實作。 您應該使用下列資訊作為指導方針，但在所有案例中可能都不正確：

實 IGlobalRSCAQueryProvider 作者會將私 BYTE 用指標宣告為名為 buffer 的成員變數;實作者會在 buffer 建構時初始化為 Null。 如果 呼叫 buffer 時 GetOutputBuffer 不是 Null，則會在 上 buffer 呼叫LocalFree函式。 呼叫LocalAlloc函式以指派 buffer 給堆積上大小 cbBuffer 的新 BYTE 陣列。 buffer如果 GetOutputBuffer 傳回S_OK，則會在取值 ppbBuffer 參數中傳回 。

重要 這個方法是 IIS 7 基礎結構的一部分，不適合直接從您的程式碼使用。

實作者的注意事項

IGlobalRSCAQueryProvider 實作者負責使用此資料的記憶體管理;因此，當不再需要動態記憶體配置時， IGlobalRSCAQueryProvider 使用動態記憶體配置的實作者必須釋放或呼叫 deleteBYTE 指標。

來電者的附注

IGlobalRSCAQueryProvider 實作者負責使用此資料的記憶體管理;因此，當不再需要此資料時， IGlobalRSCAQueryProvider 用戶端不得在傳 BYTE 回的指標上釋放或刪除。

規格需求

類型	描述
Client	- Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10上的 IIS 10.0
伺服器	- Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016上的 IIS 10.0
產品	- 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
標頭	Httpserv.h

另請參閱

IGlobalRSCAQueryProvider 介面
IGlobalRSCAQueryProvider：：ResizeOutputBuffer 方法