Metodo IByteBuffer::SetSize

Articolo
06/13/2023

[Il metodo SetSize è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Non è disponibile per l'uso in Windows Server 2003 con Service Pack 1 (SP1) e versioni successive, Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. L'interfaccia IStream offre funzionalità simili.

Il metodo SetSize modifica le dimensioni dell'oggetto stream.

Sintassi

HRESULT SetSize(
  [in] LONG libNewSize
);

Parametri

libNewSize [in]: Nuove dimensioni del flusso come numero di byte

Valore restituito

Il valore restituito è un HRESULT. Un valore di S_OK indica che la chiamata ha avuto esito positivo.

Commenti

Il metodo IByteBuffer::SetSize modifica le dimensioni dell'oggetto di flusso. Chiamare questo metodo per preallocare lo spazio per il flusso. Se il parametro libNewSize è maggiore della dimensione del flusso corrente, il flusso viene esteso alle dimensioni indicate riempiendo lo spazio di intervento con byte di valore non definito. Questa operazione è simile al metodo IByteBuffer::Write se il puntatore di ricerca è passato al termine del flusso corrente.

Se il parametro libNewSize è minore del flusso corrente, il flusso viene troncato alla dimensione indicata.

Il puntatore di ricerca non è interessato dalla modifica delle dimensioni del flusso.

La chiamata di IByteBuffer::SetSize può essere un modo efficace per ottenere un grande blocco di spazio contiguo.

Esempio

Nell'esempio seguente viene illustrata l'impostazione delle dimensioni del buffer.

LONG     lNewSize = 256;
HRESULT  hr;

// Change the buffer size.
hr = pIByteBuff->SetSize(lNewSize);
if (FAILED(hr))
  printf("Failed IByteBuffer::SetSize\n");

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Fine del supporto client	Windows XP
Fine del supporto server	Windows Server 2003
Intestazione	Scardssp.h
Libreria dei tipi	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer è definito come E126F8FE-A7AF-11D0-B88A-00C04FD424B9

Condividi tramite