Méthode IStreamAsync ::WriteAsync (shobjidl.h)

Article
03/02/2024

Écrit des informations dans un flux de manière asynchrone. Par exemple, l’interpréteur de commandes implémente cette méthode sur les éléments de fichier lors de leur transfert de manière asynchrone.

Syntaxe

HRESULT WriteAsync(
  [in]  const void   *lpBuffer,
  [in]  DWORD        cb,
  [out] LPDWORD      pcbWritten,
  [in]  LPOVERLAPPED lpOverlapped
);

Paramètres

[in] lpBuffer

Type : const void*

Pointeur vers une mémoire tampon de taille cb octets qui contient les informations à écrire dans le flux.

[in] cb

Type : DWORD

Taille de la mémoire tampon pointée par lpBuffer, en octets.

[out] pcbWritten

Type : LPDWORD

Pointeur vers une valeur DWORD qui, lorsque la méthode retourne correctement, indique le nombre réel d’octets écrits dans le flux. Cette valeur peut être NULL si ces informations ne sont pas nécessaires.

[in] lpOverlapped

Type : LPOVERLAPPED

Pointeur vers une structure OVERLAPPED qui contient des informations utilisées dans l’opération d’écriture asynchrone.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

WriteAsync doit réinitialiser l’événement spécifié par le membre hEvent de la structure OVERLAPPED à un état non signé lorsqu’il commence l’opération d’entrée/sortie (E/S).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl.h

Partager via