Método IByteBuffer::SetSize

  • Artículo

[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
Scardssp.h
Biblioteca de tipos
Scardssp.tlb
Archivo DLL
Scardssp.dll
IID
 IID_IByteBuffer se define como E126F8FE-A7AF-11D0-B88A-00C04FD424B9