Función WNetGetResourceInformationA (winnetwk.h)

Artículo
11/20/2024

Cuando se proporciona con una ruta de acceso remota a un recurso de red, la función WNetGetResourceInformation identifica el proveedor de red que posee el recurso y obtiene información sobre el tipo del recurso. La función se usa normalmente junto con la función WNetGetResourceParent para analizar e interpretar una ruta de acceso de red tipada por un usuario.

Sintaxis

DWORD WNetGetResourceInformationA(
  [in]      LPNETRESOURCEA lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpcbBuffer,
  [out]     LPSTR          *lplpSystem
);

Parámetros

[in] lpNetResource

Puntero a una estructura de NETRESOURCE de que especifica el recurso de red para el que se requiere información.

El lpRemoteName miembro de la estructura debe especificar el nombre de ruta de acceso remota del recurso, normalmente uno escrito por un usuario. Los miembros de lpProvider y dwType también deben rellenarse si se conocen, ya que esta operación puede ser intensiva en memoria, especialmente si no especifica el miembro dwType. Si no conoce los valores de estos miembros, debe establecerlos en NULL. Se omiten todos los demás miembros de la estructura NETRESOURCE.

[out] lpBuffer

Puntero al búfer para recibir el resultado. Al devolver correctamente, la primera parte del búfer es una estructura de NETRESOURCE que representa esa parte de la ruta de acceso del recurso de entrada a la que se accede a través de las funciones de WNet, en lugar de a través de funciones del sistema específicas del tipo de recurso de entrada. (El resto del búfer contiene las cadenas de longitud variable a las que los miembros del NETRESOURCE punto de estructura).

Por ejemplo, si la ruta de acceso del recurso remoto de entrada es \server\share\dir1\dir2, la salida NETRESOURCE estructura contiene información sobre el recurso \server\share. Se accede a la parte \dir1\dir2 de la ruta de acceso a través de las funciones de administración de archivos . Se devuelven los lpRemoteName, lpProvider, dwType, dwDisplayTypey dwUsage miembros de NETRESOURCE, con todos los demás miembros establecidos en NULL.

El miembro lpRemoteName se devuelve en la misma sintaxis que la devuelta de una enumeración por la función WNetEnumResource. Esto permite al autor de la llamada realizar una comparación de cadenas para determinar si el recurso pasado a WNetGetResourceInformation es el mismo que el recurso devuelto por una llamada independiente a WNetEnumResource.

[in, out] lpcbBuffer

Puntero a una ubicación que, en la entrada, especifica el tamaño del búfer de lpBuffer, en bytes. El búfer que asigne debe ser lo suficientemente grande como para contener la estructura de NETRESOURCE, además de las cadenas a las que apuntan sus miembros. Si el búfer es demasiado pequeño para el resultado, esta ubicación recibe el tamaño de búfer necesario y la función devuelve ERROR_MORE_DATA.

[out] lplpSystem

Si la función devuelve correctamente, este parámetro apunta a una cadena en el búfer de salida que especifica la parte del recurso al que se accede a través de las funciones del sistema. (Esto solo se aplica a funciones específicas del tipo de recurso en lugar de a las funciones WNet).

Por ejemplo, si el nombre del recurso remoto de entrada es \server\share\dir1\dir2, el lpRemoteName miembro de la salida NETRESOURCE estructura apunta a \server\share. Además, el parámetro lplpSystem apunta a \dir1\dir2. Ambas cadenas se almacenan en el búfer al que apunta el parámetro lpBuffer.

Valor devuelto

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

Si se produce un error en la función, el valor devuelto es un código de error del sistema , como uno de los valores siguientes.

Código devuelto	Descripción
ERROR_BAD_NET_NAME	El miembro de entrada lpRemoteName no es un recurso de red existente para ninguna red.
ERROR_BAD_DEV_TYPE	El miembro dwType de entrada no coincide con el tipo de recurso especificado por el miembro lpRemoteName.
ERROR_EXTENDED_ERROR	Error específico de la red. Llame a WNetGetLastError para obtener una descripción del error.
ERROR_MORE_DATA	El búfer al que apunta el parámetro lpBuffer es demasiado pequeño.
ERROR_NO_NETWORK	La red no está disponible.

Observaciones

Nota

El encabezado winnetwk.h define WNetGetResourceInformation como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winnetwk.h
biblioteca de	Mpr.lib
DLL de	Mpr.dll