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