Función NetUseGetInfo (lmuse.h)

Artículo
08/24/2023

La función NetUseGetInfo recupera información sobre una conexión a un recurso compartido.

También puede usar la función WNetGetConnection para recuperar el nombre de un recurso de red asociado a un dispositivo local.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetUseGetInfo(
  [in]  LMSTR  UncServerName,
  [in]  LMSTR  UseName,
  [in]  DWORD  LevelFlags,
  [out] LPBYTE *bufptr
);

Parámetros

[in] UncServerName

Nombre UNC del equipo en el que se va a ejecutar esta función. Si este parámetro es NULL, se usa el equipo local. Si el parámetro UncServerName especificado es un equipo remoto, el equipo remoto debe admitir llamadas RPC remotas mediante el mecanismo heredado protocolo de acceso remoto.

Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .

[in] UseName

Puntero a una cadena que especifica el nombre de la conexión para la que se va a devolver información.

Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .

[in] LevelFlags

Nivel de información de los datos solicitados. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
0	Especifica un nombre de dispositivo local y el nombre del recurso compartido de un recurso remoto. El parámetro BufPtr es un puntero a una estructura USE_INFO_0 .
1	Especifica información sobre la conexión entre un dispositivo local y un recurso compartido, incluido el estado y el tipo de conexión. El parámetro BufPtr es un puntero a una estructura USE_INFO_1 .
2	Especifica información sobre la conexión entre un dispositivo local y un recurso compartido. La información incluye el estado de conexión, el tipo de conexión, el nombre de usuario y el nombre de dominio. El parámetro BufPtr es un puntero a una estructura USE_INFO_2 .

[out] bufptr

Puntero al búfer que recibe los datos. 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 realiza correctamente, el valor devuelto es NERR_Success.

Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista de códigos de error, consulte Códigos de error del sistema.

Comentarios

No se requiere ninguna pertenencia especial a grupos para llamar a la función NetUseGetInfo . Esta función no se puede ejecutar en un servidor remoto, excepto en casos de compatibilidad de nivel inferior.

Para enumerar todas las conexiones actuales entre el equipo local y los recursos de los servidores remotos, puede llamar a la función NetUseEnum .

Esta función solo se aplica al cliente del bloque de mensajes del servidor (estación de trabajo del administrador de LAN). La función NetUseGetInfo no admite recursos compartidos del sistema de archivos distribuidos (DFS). Para recuperar información de un recurso compartido mediante un proveedor de red diferente (WebDAV o un recurso compartido DFS, por ejemplo), use la función WNetGetConnection .

Requisitos


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