Metodo ILockBytes::SetSize (objidl.h)

Articolo
03/09/2024

Il metodo SetSize modifica le dimensioni della matrice di byte.

Sintassi

HRESULT SetSize(
  [in] ULARGE_INTEGER cb
);

Parametri

[in] cb

Specifica le nuove dimensioni della matrice di byte come numero di byte.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Le dimensioni della matrice di byte sono state modificate correttamente.
STG_E_ACCESSDENIED	Il chiamante non dispone dell'autorizzazione per accedere alla matrice di byte.
STG_E_MEDIUMFULL	La dimensione della matrice di byte non viene modificata perché non vi è spazio lasciato nel dispositivo di archiviazione.

Commenti

ILockBytes::SetSize modifica le dimensioni della matrice di byte. Se il parametro cb è maggiore della matrice di byte corrente, la matrice di byte viene estesa alla dimensione indicata riempiendo lo spazio di intervento con byte di valore non definito, come fa ILockBytes::WriteAt, se il puntatore di ricerca è passato il punto di fine del flusso corrente.

Se il parametro cb è minore della matrice di byte corrente, la matrice di byte viene troncata alla dimensione indicata.

Note ai chiamanti

I chiamanti non possono basarsi su STG_E_MEDIUMFULL restituiti al momento appropriato a causa del buffer della cache nel sistema operativo o nella rete. Tuttavia, i chiamanti devono essere in grado di gestire questo codice restituito perché alcune implementazioni di ILockBytes potrebbero supportarlo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	objidl.h
Libreria	Uuid.lib
DLL	Ole32.dll