Metodo IStreamAsync::WriteAsync (shobjidl.h)

Articolo
03/05/2024

Scrive le informazioni in un flusso in modo asincrono. Ad esempio, Shell implementa questo metodo sugli elementi di file durante il trasferimento asincrono.

Sintassi

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

Parametri

[in] lpBuffer

Tipo: const void*

Puntatore a un buffer di dimensioni cb byte che contiene le informazioni da scrivere nel flusso.

[in] cb

Tipo: DWORD

Dimensioni del buffer a cui punta lpBuffer, in byte.

[out] pcbWritten

Tipo: LPDWORD

Puntatore a un valore DWORD che, quando il metodo restituisce correttamente, indica il numero effettivo di byte scritti nel flusso. Questo valore può essere NULL se queste informazioni non sono necessarie.

[in] lpOverlapped

Tipo: LPOVERLAPPED

Puntatore a una struttura OVERLAPPED che contiene informazioni utilizzate nell'operazione di scrittura asincrona.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

WriteAsync deve reimpostare l'evento specificato dal membro hEvent della struttura OVERLAPPED a uno stato non assegnato all'avvio dell'operazione di input/output (I/O).

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl.h

Condividi tramite