Función WNetOpenEnumA (winnetwk.h)
La función
DWORD WNetOpenEnumA(
[in] DWORD dwScope,
[in] DWORD dwType,
[in] DWORD dwUsage,
[in] LPNETRESOURCEA lpNetResource,
[out] LPHANDLE lphEnum
);
[in] dwScope
Ámbito de la enumeración. Este parámetro puede ser uno de los siguientes valores.
[in] dwType
Tipos de recursos que se van a enumerar. Este parámetro puede ser una combinación de los siguientes valores.
Si un proveedor de red no puede distinguir entre los recursos de impresión y disco, puede enumerar todos los recursos.
[in] dwUsage
Tipo de uso de recursos que se va a enumerar. Este parámetro puede ser una combinación de los siguientes valores.
Este parámetro se omite a menos que el parámetro dwScope sea igual a RESOURCE_GLOBALNET. Para obtener más información, vea la siguiente sección Comentarios.
[in] lpNetResource
Puntero a una estructura de NETRESOURCE que especifica el contenedor que se va a enumerar. Si el parámetro dwScope no está RESOURCE_GLOBALNET, este parámetro debe ser NULL.
Si este parámetro es NULL, se asume la raíz de la red. (El sistema organiza una red como una jerarquía; la raíz es el contenedor más alto de la red).
Si este parámetro no es null, debe apuntar a una estructura de NETRESOURCE. La aplicación puede rellenar esta estructura o se puede devolver mediante una llamada a la función WNetEnumResource. La estructura
Para enumerar todos los recursos de red, una aplicación puede comenzar la enumeración llamando a WNetOpenEnum con el parámetro lpNetResource establecido en NULLy, a continuación, use el identificador devuelto para llamar a WNetEnumResource para enumerar los recursos. Si uno de los recursos de la matriz de NETRESOURCE devuelto por la función WNetEnumResource es un recurso de contenedor, puede llamar a WNetOpenEnum para abrir el recurso para una enumeración adicional.
[out] lphEnum
Puntero a un identificador de enumeración que se puede usar en una llamada posterior a WNetEnumResource.
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 |
---|---|
|
El parámetro lpNetResource no apunta a un contenedor. |
|
El dwScope o el parámetro dwType no es válido o hay una combinación no válida de parámetros. |
|
La red no está disponible. |
|
Error específico de la red. Para obtener una descripción del error, llame a la función |
|
Nombre de recurso de red remoto proporcionado en la estructura de NETRESOURCE de |
Si el parámetro
La interpretación exacta de RESOURCE_CONTEXT en el parámetro dwScope depende de las redes instaladas en la máquina.
La función
LanMan (container, in this case the provider)
ACCOUNTING (container, in this case the domain)
\\ACCTSPAY (container, in this case the server)
PAYFILES (disk)
LASERJET (print)
NetWare (container, in this case the provider)
MARKETING (container, in this case the server)
SYS (disk, first one on any NetWare server)
ANOTHERVOLUME (disk)
LASERJET (print)
Para obtener un ejemplo de código que muestra una función definida por la aplicación que enumera todos los recursos de una red, consulte Enumeración de recursos de red.
Nota
El encabezado winnetwk.h define WNetOpenEnum 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.
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 |
WNetCloseEnum de