Partager via


ILockBytes ::SetSize, méthode (objidl.h)

La méthode SetSize modifie la taille du tableau d’octets.

Syntaxe

HRESULT SetSize(
  [in] ULARGE_INTEGER cb
);

Paramètres

[in] cb

Spécifie la nouvelle taille du tableau d’octets sous la forme d’un nombre d’octets.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK La taille du tableau d’octets a été modifiée.
STG_E_ACCESSDENIED L’appelant n’est pas autorisé à accéder au tableau d’octets.
STG_E_MEDIUMFULL La taille du tableau d’octets n’est pas modifiée, car il n’y a plus d’espace sur le périphérique de stockage.

Remarques

ILockBytes ::SetSize modifie la taille du tableau d’octets. Si le paramètre cb est plus grand que le tableau d’octets actuel, le tableau d’octets est étendu à la taille indiquée en remplissant l’espace intermédiaire avec des octets de valeur non définie, comme le fait ILockBytes ::WriteAt, si le pointeur de recherche dépasse la fin du flux actuel.

Si le paramètre cb est plus petit que le tableau d’octets actuel, le tableau d’octets est tronqué à la taille indiquée.

Remarques aux appelants

Les appelants ne peuvent pas compter sur STG_E_MEDIUMFULL retournés au moment approprié en raison de la mise en mémoire tampon dans le système d’exploitation ou le réseau. Toutefois, les appelants doivent être en mesure de gérer ce code de retour, car certaines implémentations ILockBytes peuvent le prendre en charge.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête objidl.h
Bibliothèque Uuid.lib
DLL Ole32.dll

Voir aussi

ILockBytes - Implémentation File-Based

ILockBytes - Implémentation de la mémoire globale

ILockBytes ::ReadAt

ILockBytes ::WriteAt