Funzione FindFirstStreamW (fileapi.h)

Articolo
08/23/2023

Enumera il primo flusso con un tipo di flusso ::$DATA nel file o nella directory specificata.

Per eseguire questa operazione come operazione transazionata, utilizzare la funzione FindFirstStreamTransactedW .

Sintassi

HANDLE FindFirstStreamW(
  [in]  LPCWSTR            lpFileName,
  [in]  STREAM_INFO_LEVELS InfoLevel,
  [out] LPVOID             lpFindStreamData,
        DWORD              dwFlags
);

Parametri

[in] lpFileName

Nome completo del file.

[in] InfoLevel

Livello di informazioni dei dati restituiti. Questo parametro è uno dei valori nel tipo di enumerazione STREAM_INFO_LEVELS .

Valore	Significato
FindStreamInfoStandard 0	I dati vengono restituiti in una struttura WIN32_FIND_STREAM_DATA .

[out] lpFindStreamData

Puntatore a un buffer che riceve i dati del flusso di file. Il formato di questi dati dipende dal valore del parametro InfoLevel .

dwFlags

Riservato per utilizzi futuri. Questo parametro deve essere zero.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle di ricerca che può essere usato nelle chiamate successive alla funzione FindNextStreamW .

Se la funzione ha esito negativo, il valore restituito viene INVALID_HANDLE_VALUE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Se non è possibile trovare flussi, la funzione ha esito negativo e GetLastError restituisce ERROR_HANDLE_EOF (38).

Se il file system non supporta i flussi, la funzione ha esito negativo e GetLastError restituisce ERROR_INVALID_PARAMETER (87).

Commenti

La funzione FindFirstStreamW apre un handle di ricerca e restituisce informazioni sul primo flusso $DATA nel file o nella directory specificata. Per i file, si tratta sempre del flusso di dati predefinito senza nome "::$DATA". Le directory non dispongono di flussi $DATA per impostazione predefinita e non possono avere un flusso di dati senza nome, ma potrebbero aver impostato flussi di dati denominati dopo la creazione. Dopo aver stabilito l'handle di ricerca, usarlo nelle chiamate alla funzione FindNextStreamW per cercare altri flussi nel file o nella directory specificata. Quando l'handle di ricerca non è più necessario, deve essere chiuso usando la funzione FindClose .

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia	Supportato
Protocollo SMB (Server Message Block) 3.0	Sì
Failover trasparente SMB 3.0 (TFO)	Sì
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO)	Sì
File system del volume condiviso cluster (CsvFS)	Sì
Resilient File System (ReFS)	Sì

SMB 3.0 supporta l'elenco di flussi minori o uguali a 64K.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	fileapi.h (include Windows.h, WinBase.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll