Compartir a través de

ANETRESOURCES( ) (Función)

  • Artículo

Coloca los nombres de los recursos compartidos de red e impresoras en una matriz y después devuelve el número de recursos.

ANETRESOURCES(ArrayName, cNetworkName, nResourceType)

Valores devueltos

Numeric

Parámetros

  • ArrayName
    Especifica el nombre de la matriz que contiene la información acerca de los recursos compartidos de la red o impresoras. Si la matriz que especifica no existe, Visual FoxPro la creará automáticamente. Si la matriz existe y no es suficientemente grande para contener toda la información, Visual FoxPro aumentará automáticamente su tamaño para dar cabida a la información. Si la matriz es mayor de lo necesario, Visual FoxPro reducirá su tamaño.

    Si la matriz existe y ANETRESOURCES( ) devuelve 0 debido a que no se han encontrado recursos compartidos de la red o impresoras, la matriz no sufre cambios. Si la matriz no existe y ANETRESOURCES( ) devuelve 0, la matriz no se crea.

  • cNetworkName
    Especifica el nombre de red o dominio del que se devuelve la información de recurso compartido o de impresora. El nombre de red debe tener el formato "\\NetworkName". No necesita estar conectado a la red que especifique y especificar una red no le conecta a ella. Si especifica un nombre de dominio, el resultado de ANETRESOURCES( ) será una matriz con los miembros o recursos procedentes del dominio.

  • nResourceType
    Especifica el tipo de recurso de red del que se devuelve la información. Los nombres de los recursos compartidos en la red se devuelven si nResourceType da como resultado 1. Los nombres de las impresoras de la red se devuelven si nResourceType da como resultado 2. Un valor de 0 devuelve el nombre de cualquier recurso.

Observaciones

ANETRESOURCES( ) devuelve el número de recursos compartidos o impresoras encontradas (es idéntico al número de filas de la matriz). ANETRESOURCES( ) devuelve cero si no hay recursos compartidos o impresoras para el tipo de red que haya especificado, o si la red que especificó no existe.

Si desea obtener información detallada, consulte las funciones API de Win32 WNetOpenEnum y WNetEnumResource.

Vea también

ADIR( ) | Incluir recursos en sus aplicaciones | APRINTERS( ) | GETPRINTER( )