Compartir a través de

Estructura NETRESOURCEW (winnetwk.h)

  • Artículo

La estructura siguiente contiene información sobre un recurso de red. Se usa en varias de las funciones del proveedor de red, incluidas NPOpenEnum y NPAddConnection.

Sintaxis

typedef struct _NETRESOURCEW {
  DWORD  dwScope;
  DWORD  dwType;
  DWORD  dwDisplayType;
  DWORD  dwUsage;
  LPWSTR lpLocalName;
  LPWSTR lpRemoteName;
  LPWSTR lpComment;
  LPWSTR lpProvider;
} NETRESOURCEW, *LPNETRESOURCEW;

Miembros

dwScope

Indica el ámbito de la enumeración. Puede ser uno de los siguientes valores.

Valor Significado
RESOURCE_CONNECTED
 Conexiones actuales a recursos de red.
RESOURCE_GLOBALNET
 Todos los recursos de red. Pueden estar conectados o no.
RESOURCE_CONTEXT
 Los recursos de red asociados al contexto de red actual y predeterminado del usuario. El significado de esto es específico del proveedor.

dwType

Indica el tipo de recurso. Puede ser uno de los siguientes valores.

Valor Significado
RESOURCETYPE_DISK
 El recurso es un volumen de disco compartido.
RESOURCETYPE_PRINT
 El recurso es una impresora compartida.
RESOURCETYPE_ANY
 El recurso coincide con más de un tipo, por ejemplo, un contenedor de recursos de impresión y disco, o un recurso que no es impresión ni disco.

dwDisplayType

Establezca el proveedor para indicar qué tipo de presentación debe usar una interfaz de usuario para representar este recurso. Se definen los siguientes tipos.

Valor Significado
RESOURCEDISPLAYTYPE_NETWORK
 El recurso es un proveedor de red.
RESOURCEDISPLAYTYPE_DOMAIN
 El recurso es una colección de servidores.
RESOURCEDISPLAYTYPE_SERVER
 El recurso es un servidor.
RESOURCEDISPLAYTYPE_SHARE
 El recurso es un punto de recurso compartido.
RESOURCEDISPLAYTYPE_DIRECTORY
 El recurso es un directorio.
RESOURCEDISPLAYTYPE_GENERIC
 El tipo de recurso no está especificado. Los proveedores de red usan este valor que no especifican tipos de recursos.

dwUsage

Máscara de bits que indica cómo puede enumerar información sobre el recurso. Solo se define si dwScope está establecido en RESOURCE_GLOBALNET. El campo dwUsage puede contener una o varias de las marcas siguientes.

Valor Significado
RESOURCEUSAGE_CONNECTABLE
 Puede conectarse al recurso llamando a NPAddConnection. Si dwType es RESOURCETYPE_DISK, después de conectarse al recurso, puede usar las API del sistema de archivos, como FindFirstFiley FindNextFile, para enumerar los archivos y directorios que contiene el recurso.
RESOURCEUSAGE_CONTAINER
 El recurso es un contenedor para otros recursos que se pueden enumerar mediante las funciones de NPOpenEnum, NPEnumResourcey NPCloseEnum.

Sin embargo, el contenedor puede estar vacío en el momento en que se realiza la enumeración. Es decir, la primera llamada a NPEnumResource puede devolver WN_NO_MORE_ENTRIES.

lpLocalName

Si dwScope es RESOURCE_CONNECTED, el campo lpLocalName contiene el nombre de un dispositivo redirigido. Si la conexión es una conexión sin dispositivo, este campo contiene NULL.

Si dwScope no está establecido en RESOURCE_CONNECTED, este campo no está definido.

lpRemoteName

Si el elemento enumerado es un recurso de red, este campo contiene un nombre de red remoto. Este nombre se puede pasar a NPAddConnection para realizar una conexión de red si dwUsage está establecido en RESOURCEUSAGE_CONNECTABLE. Si el elemento enumerado es una conexión actual, este campo hará referencia al nombre de red remoto al que está conectado lpLocalName.

lpComment

Puede ser cualquier comentario proporcionado por el proveedor asociado al elemento enumerado.

lpProvider

Especifica el nombre del proveedor que posee este elemento enumerado.

Observaciones

Nota

El encabezado winnetwk.h define NETRESOURCE 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 XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de winnetwk.h