Función FindFirstFileNameW (fileapi.h)

  • Artículo

Crea una enumeración de todos los vínculos físicos al archivo especificado. La función FindFirstFileNameW devuelve un identificador a la enumeración que se puede usar en llamadas subsiguientes a la función FindNextFileNameW.

Para realizar esta operación como una operación de transacción, use la función FindFirstFileNameTransactedW .

Sintaxis

HANDLE FindFirstFileNameW(
  [in]      LPCWSTR lpFileName,
  [in]      DWORD   dwFlags,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

Parámetros

[in] lpFileName

Nombre del archivo.

Propina A partir de Windows 10, versión 1607, puede optar por quitar la limitación de MAX_PATH sin tener que prepending "\\?\". Consulte la sección "Limitación máxima de longitud de ruta de acceso" de Nombres de archivos, rutas de acceso y espacios de nombres para obtener más información.
 

[in] dwFlags

Reservados; especifique cero (0).

[in, out] StringLength

Tamaño del búfer al que apunta el parámetro LinkName , en caracteres. Si se produce un error en esta llamada y el error devuelto por la función GetLastError es ERROR_MORE_DATA (234), el valor devuelto por este parámetro es el tamaño al que el búfer apuntado por LinkName debe contener todos los datos.

[in, out] LinkName

Puntero a un búfer para almacenar el nombre del primer vínculo encontrado para lpFileName.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador de búsqueda que se puede usar con la función FindNextFileNameW o cerrada con la función FindClose .

Si se produce un error en la función, el valor devuelto es INVALID_HANDLE_VALUE (0xffffffff). Para obtener información ampliada de los errores, llame a la función GetLastError.

Comentarios

En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.

Tecnología Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0 Sí
Conmutación por error transparente (TFO) de SMB 3.0 No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) No
Sistema de archivos de Volumen compartido de clúster (CsvFS) Sí
Sistema de archivos resistente a errores (ReFS) Sí

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado fileapi.h (incluya Windows.h, WinBase.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones de administración de archivos

FindClose

FindFirstFileNameTransactedW

FindNextFileNameW