Estructura NETRESOURCEA (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 _NETRESOURCEA {
  DWORD dwScope;
  DWORD dwType;
  DWORD dwDisplayType;
  DWORD dwUsage;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  LPSTR lpComment;
  LPSTR lpProvider;
} NETRESOURCEA, *LPNETRESOURCEA;

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. Estos 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 ni impresión ni disco.

dwDisplayType

Establezca por 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 que no especifican tipos de recursos usan este valor.

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 FindFirstFile y 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 NPOpenEnum, NPEnumResource y 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.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winnetwk.h