建立新的 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 方法