ANETRESOURCES( )-Funktion

  • Artikel

Platziert die gemeinsam genutzten Netzwerknamen oder –drucker in ein Array und gibt dann die Anzahl der Ressourcen zurück.

ANETRESOURCES(ArrayName, cNetworkName, nResourceType)

Rückgabewerte

Numerisch

Parameter

  • ArrayName
    Gibt den Namen des Arrays an, das die Informationen über die gemeinsam genutzten Netzwerknamen oder –drucker enthält. Ist das angegebene Array nicht vorhanden, wird es von Visual FoxPro automatisch erstellt. Ist das Array vorhanden, aber nicht groß genug, um alle Informationen aufnehmen zu können, passt Visual FoxPro die Größe des Arrays automatisch entsprechend an. Ist das Array größer als notwendig, wird es abgeschnitten.

    Wenn das Array vorhanden ist und ANETRESOURCES( ) 0 zurückgibt, weil keine der gemeinsam genutzten Netzwerknamen oder –drucker gefunden wurden, werden keine Änderungen an dem Array vorgenommen. Wenn das Array nicht vorhanden ist und ANETRESOURCES( ) 0 zurückgibt, wird das Array nicht erstellt.

  • cNetworkName
    Gibt den Namen des Netzwerks oder der Domäne an, für das bzw. die die Informationen zu gemeinsam genutzten Netzwerknamen oder –druckern zurückgegeben werden. Der Netzwerkname sollte das Format \\Netzwerkname. haben. Sie brauchen mit dem angegebenen Netzwerk nicht verbunden zu sein, und die Angabe eines Netzwerks bewirkt auch nicht, dass Sie mit selbigem verbunden werden. Wenn Sie einen Domänennamen angeben, gibt ANETRESOURCES( ) ein Array der Mitglieder oder Ressourcen dieser Domäne zurück.

  • nResourceType
    Gibt den Typ der Netzwerkressourcen an, für den Informationen zurückzugeben sind. Die Namen gemeinsam genutzter Ressourcen im Netzwerk werden zurückgegeben, wenn nResourceType zu 1 ausgewertet wird. Wird nResourceType zu 2 ausgewertet, werden die Namen von Druckern im Netzwerk zurückgegeben. Bei dem Wert 0 wird der Name einer beliebigen Ressource zurückgegeben.

Hinweise

ANETRESOURCES( ) gibt die Anzahl der gemeinsam genutzten Netzwerknamen oder gefundenen Drucker zurück (identisch mit der Zeilenzahl im Array). ANETRESOURCES( ) gibt Null zurück, wenn keine gemeinsam genutzten Ressourcen oder Drucker für den Typ des angegebenen Netzwerks gefunden wurden oder das von Ihnen angegebene Netzwerk nicht vorhanden ist.

Weitere Informationen finden Sie bei den Win32 API-Funktionen WNetOpenEnum und WNetEnumResource.

Siehe auch

ADIR( ) | Einbinden von Ressourcen in Anwendungen | APRINTERS( ) | GETPRINTER( )