Método IByteBuffer::SetSize
[El método SetSize está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. No está disponible para su uso en Windows Server 2003 con Service Pack 1 (SP1) y versiones posteriores, Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La interfaz IStream proporciona una funcionalidad similar.]
El método SetSize cambia el tamaño del objeto de secuencia.
Sintaxis
HRESULT SetSize(
[in] LONG libNewSize
);
Parámetros
-
libNewSize [in]
-
Nuevo tamaño de la secuencia como un número de bytes
Valor devuelto
El valor devuelto es hrESULT. Un valor de S_OK indica que la llamada se realizó correctamente.
Comentarios
El método IByteBuffer::SetSize cambia el tamaño del objeto de secuencia. Llame a este método para asignar previamente espacio para la secuencia. Si el parámetro libNewSize es mayor que el tamaño de la secuencia actual, la secuencia se extiende al tamaño indicado rellenando el espacio intermedio con bytes de valor indefinido. Esta operación es similar al método IByteBuffer::Write si el puntero de búsqueda está más allá del final de secuencia actual.
Si el parámetro libNewSize es menor que el flujo actual, la secuencia se trunca al tamaño indicado.
El puntero de búsqueda no se ve afectado por el cambio en el tamaño de la secuencia.
Llamar a IByteBuffer::SetSize puede ser una manera eficaz de intentar obtener un gran fragmento de espacio contiguo.
Ejemplos
En el ejemplo siguiente se muestra cómo establecer el tamaño del búfer.
LONG lNewSize = 256;
HRESULT hr;
// Change the buffer size.
hr = pIByteBuff->SetSize(lNewSize);
if (FAILED(hr))
printf("Failed IByteBuffer::SetSize\n");
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |
| Fin de compatibilidad de cliente |
Windows XP |
| Fin de compatibilidad de servidor |
Windows Server 2003 |
| Encabezado |
|
| Biblioteca de tipos |
|
| Archivo DLL |
|
| IID |
IID_IByteBuffer se define como E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |