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

Article
02/29/2024

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