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