Metodo ILockBytes::SetSize (objidl.h)

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

Vedi anche

ILockBytes - Implementazione di File-Based

ILockBytes - Implementazione globale della memoria

ILockBytes::ReadAt

ILockBytes::WriteAt