Compartir a través de

Función NPOpenEnum (npapi.h)

  • Artículo

Abre una enumeración de recursos de red o conexiones existentes. Se debe llamar a la función NPOpenEnum para obtener un identificador válido para una enumeración.

Sintaxis

DWORD NPOpenEnum(
  [in]  DWORD          dwScope,
  [in]  DWORD          dwType,
  [in]  DWORD          dwUsage,
  [in]  LPNETRESOURCEW lpNetResource,
  [out] LPHANDLE       lphEnum
);

Parámetros

[in] dwScope

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

Valor Significado
RESOURCE_CONNECTED
 Todos los recursos conectados actualmente.
RESOURCE_GLOBALNET
 Todos los recursos de la red.
RESOURCE_CONTEXT
 Los recursos asociados al contexto de red actual y predeterminado del usuario (se usan para una vista "Vecindario de red"). La interpretación de esto se deja al proveedor.

[in] dwType

Especifica el tipo de recursos de interés. Se trata de una máscara de bits, que puede ser cualquier combinación de las marcas siguientes.

Valor Significado
RESOURCETYPE_DISK
 Todos los recursos de disco.
RESOURCETYPE_PRINT
 Todos los recursos de impresión.
RESOURCEUSAGE_ATTACHED
 Especifica que la función debe producir un error si el autor de la llamada no está autenticado (incluso si la red permite la enumeración sin autenticación).
 

Si dwType es 0 o es simplemente RESOURCEUSAGE_ATTACHED, se devuelven todos los tipos de recursos. Si un proveedor no tiene la capacidad de distinguir entre los recursos de impresión y disco en el mismo nivel, puede devolver todos los recursos.

[in] dwUsage

Especifica el uso de recursos de interesados. Se trata de una máscara de bits, que puede ser cualquier combinación de las marcas siguientes.

Valor Significado
RESOURCEUSAGE_CONNECTABLE
 Todos los recursos conectables
RESOURCEUSAGE_CONTAINER
 Todos los recursos de contenedor
 

La máscara de bits puede ser cero para que coincida con todas las marcas. Este parámetro se puede omitir si dwScope no está establecido en RESOURCE_GLOBALNET.

[in] lpNetResource

Puntero al contenedor para realizar la enumeración. NETRESOURCE podría haberse obtenido a través de una llamada a NPEnumResource anterior o construida por el autor de la llamada, o bien puede ser NULL. Si es NULL o si el campo lpRemoteName del NETRESOURCE es NULL, el proveedor debe enumerar el nivel superior de su red. Tenga en cuenta que esto significa que un proveedor no puede usar un lpRemoteName de NULL para representar ningún recurso de red. Normalmente, un llamador empezaría llamando a NPOpenEnum con este parámetro establecido en NULL y, a continuación, usaría los resultados devueltos para una enumeración adicional. Si el programa de llamada conoce exactamente el proveedor y la ruta de acceso remota desde la que se va a enumerar, puede crear su propia estructura NETRESOURCE para pasar, rellenando los campos lpProvider y lpRemoteName . Tenga en cuenta que si dwScope está RESOURCE_CONNECTED o RESOURCE_CONTEXT, este parámetro será NULL.

[out] lphEnum

Puntero a un identificador que puede usar la función NPEnumResource . Cuando haya terminado de usar el identificador, libere el identificador llamando a la función NPCloseEnum .

Valor devuelto

Si la función se ejecuta correctamente, debe devolver WN_SUCCESS. De lo contrario, debe devolver un código de error que puede incluir uno de los siguientes.

Código devuelto Descripción
WN_NOT_SUPPORTED
 El proveedor no admite el tipo de enumeración que se solicita o no se puede examinar el recurso de red específico.
WN_NOT_CONTAINER
 lpNetResource no apunta a un contenedor.
WN_BAD_VALUE
 Se especifica una combinación incorrecta de dwScope, dwUsage o dwType o una combinación incorrecta de parámetros.
WN_NO_NETWORK
 La red no está presente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado npapi.h