Función NetFileGetInfo (lmshare.h)

Artículo
03/14/2023

Recupera información sobre una apertura determinada de un recurso de servidor.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetFileGetInfo(
  [in]  LMSTR  servername,
  [in]  DWORD  fileid,
  [in]  DWORD  level,
  [out] LPBYTE *bufptr
);

Parámetros

[in] servername

Puntero a una cadena que especifica el nombre DNS o NetBIOS del servidor remoto en el que se va a ejecutar la función. Si este parámetro es NULL, se usa el equipo local.

Esta cadena es Unicode si se define _WIN32_WINNT o FORCE_UNICODE .

[in] fileid

Especifica el identificador de archivo del recurso abierto para el que se va a devolver información. El valor de este parámetro debe haberse devuelto en una llamada de enumeración anterior. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

[in] level

Especifica el nivel de información de los datos. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
2	Devuelve el número de identificación del archivo. El parámetro bufptr es un puntero a una estructura FILE_INFO_2 .
3	Devuelve el número de identificación del archivo y otra información sobre el archivo. El parámetro bufptr es un puntero a una estructura FILE_INFO_3 .

[out] bufptr

Puntero a la dirección del búfer que recibe la información. El formato de estos datos depende del valor del parámetro level . El sistema asigna este búfer y se debe liberar mediante la función NetApiBufferFree . Para obtener más información, consulte Network Management Function Buffers (Búferes de funciones de administración de red) y Network Management Function Buffer Lengths (Longitudes de búfer de funciones de administración de red).

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NERR_Success.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.

Código devuelto	Descripción
ERROR_ACCESS_DENIED	El usuario no tiene acceso a la información pedida.
ERROR_FILE_NOT_FOUND	No se encontró el archivo.
ERROR_INVALID_LEVEL	El valor especificado para el parámetro level no es válido.
ERROR_NOT_ENOUGH_MEMORY	No hay suficiente memoria disponible.
NERR_BufTooSmall	El búfer proporcionado es demasiado pequeño.

Comentarios

Solo los miembros del grupo local Administradores o Operadores de servidor pueden ejecutar correctamente la función NetFileGetInfo .

Puede llamar a la función NetFileEnum para recuperar información sobre varios archivos abiertos en un servidor.

Si está programando para Active Directory, es posible que pueda llamar a determinados métodos de interfaz de servicio de Active Directory (ADSI) para lograr la misma funcionalidad que puede lograr llamando a NetFileGetInfo. Para obtener más información, vea IADsResource e IADsFileServiceOperations.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	lmshare.h (include Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll