Funzione FindFirstStreamW (fileapi.h)
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 |
|---|---|
|
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 |