ILockBytes ::WriteAt, méthode (objidl.h)
La méthode WriteAt écrit le nombre spécifié d’octets en commençant à un décalage spécifié par rapport au début du tableau d’octets.
Syntaxe
HRESULT WriteAt(
[in] ULARGE_INTEGER ulOffset,
[in] const void *pv,
[in] ULONG cb,
[out] ULONG *pcbWritten
);
Paramètres
[in] ulOffset
Spécifie le point de départ à partir du début du tableau d’octets pour les données à écrire.
[in] pv
Pointeur vers la mémoire tampon contenant les données à écrire.
[in] cb
Spécifie le nombre d’octets de données à tenter d’écrire dans le tableau d’octets.
[out] pcbWritten
Pointeur vers un emplacement où cette méthode spécifie le nombre réel d’octets écrits dans le tableau d’octets. Vous pouvez définir ce pointeur sur NULL pour indiquer que cette valeur ne vous intéresse pas. Dans ce cas, cette méthode ne fournit pas le nombre réel d’octets écrits.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
| S_OK | Indique que le nombre d’octets spécifié a été écrit. |
| E_FAIL | Une défaillance générale s’est produite pendant l’opération d’écriture. |
| E_PENDING | Stockage asynchrone uniquement : une partie ou la totalité des données à écrire ne sont actuellement pas disponibles. |
| STG_E_ACCESSDENIED | L’appelant ne dispose pas des autorisations suffisantes pour écrire ce tableau d’octets. |
| STG_E_WRITEFAULT | Le nombre d’octets à écrire n’est pas égal au nombre d’octets qui ont été réellement écrits. |
| STG_E_MEDIUMFULL | L’opération d’écriture n’a pas été terminée, car il n’y a plus d’espace sur le périphérique de stockage. Le nombre réel d’octets écrits est toujours retourné dans pcbWritten. |
Remarques
ILockBytes ::WriteAt écrit les données spécifiées à l’emplacement spécifié dans le tableau d’octets. Le nombre d’octets réellement écrits doit toujours être retourné dans pcbWritten, même si une erreur est retournée. Si le nombre d’octets est égal à zéro octet, l’opération d’écriture n’a aucun effet.
Si ulOffset dépasse la fin du tableau d’octets et que cb est supérieur à zéro, ILockBytes ::WriteAt augmente la taille du tableau d’octets. Les octets de remplissage écrits dans le tableau d’octets ne sont pas initialisés à une valeur particulière.
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