Functions > Network >

InetGetInfo

Obtient des informations d�taill�es sur le handle retourn� par InetGet().

InetGetInfo ( [handle [, index = -1]] )

Param�tres

handle [optionnel] Le handle retourn� par InetGet().
index [optionnel] L'index des donn�es � r�cup�rer. Si cette valeur est -1, un tableau contenant toutes les donn�es ci-dessous sera retourn�.
    $INET_DOWNLOADREAD (0) - Octets lus jusqu'� pr�sent (mis � jour durant la progression du t�l�chargement).
    $INET_DOWNLOADSIZE (1) - La taille du t�l�chargement en octets (n'est pas toujours pr�sent).
    $INET_DOWNLOADCOMPLETE (2) - Met � True si le t�l�chargement est termin�, False si le t�l�chargement est en cours.
    $INET_DOWNLOADSUCCESS (3) - True si le t�l�chargement est un succ�s. Si False alors le membre de donn�e suivant ne sera pas nul.
    $INET_DOWNLOADERROR (4) - La valeur d'erreur pour le t�l�chargement. La valeur elle-m�me est arbitraire. Tester si la valeur n'est pas nulle est suffisant pour d�terminer si une erreur s'est produite.
    $INET_DOWNLOADEXTENDED (5) - La valeur compl�mentaire pour le t�l�chargement. La valeur est arbitraire et est principalement utile aux d�veloppeurs d'AutoIt.

Les constantes sont d�finies dans InetConstants.au3

Valeur de retour

Succ�s: Retourne les informations demand�es.
�chec: Retourne une cha�ne vide et d�finit @error <> 0.

Remarques

Si la fonction est appel�e sans aucun argument alors le nombre total de t�l�chargements actifs sera retourn�.

Cette fonction peut-�tre appel�e dans une boucle pour r�cup�rer le nombre d'octets t�l�charg�s ou pour faire une pause jusqu'� ce que le t�l�chargement soit complet.

En relation

InetGet

Exemple

#include <InetConstants.au3>
#include <MsgBoxConstants.au3>
#include <WinAPIFiles.au3>

Example()

Func Example()
    ; Enregistre le fichier t�l�charg� dans le dossier temporaire.
    Local $sFilePath = _WinAPI_GetTempFileName(@TempDir)

    ; T�l�charge le fichier en arri�re-plan avec l'option "forcer le chargement du site distant."
    Local $hDownload = InetGet("http://www.autoitscript.com/autoit3/files/beta/update.dat", $sFilePath, $INET_FORCERELOAD, $INET_DOWNLOADBACKGROUND)

    ; Attend la fin du t�l�chargement pour v�rifier si la valeur du 2nd index de InetGetInfo retourne True.
    Do
        Sleep(250)
    Until InetGetInfo($hDownload, $INET_DOWNLOADCOMPLETE)

    ; R�cup�re des informations sur le fichier de t�l�chargement.
    Local $aData = InetGetInfo($hDownload)
    If @error Then 
        FileDelete($sFilePath))
        Return False ; Si une erreur se produit la fonction retourne et supprime le fichier.
    EndIf

    ; Ferme le handle retourn� par InetGet.
    InetClose($hDownload)

    ; Affiche les informations sur le fichier t�l�charg�.
    MsgBox($MB_SYSTEMMODAL, "", "Bytes read: " & $aData[$INET_DOWNLOADREAD] & @CRLF & _ ; Ou utilisez 0 � la place de la constante.
            "Taille: " & $aData[$INET_DOWNLOADSIZE] & @CRLF & _ 
            "Complet: " & $aData[$INET_DOWNLOADCOMPLETE] & @CRLF & _
            "Succ�s: " & $aData[$INET_DOWNLOADSUCCESS] & @CRLF & _
            "@error: " & $aData[$INET_DOWNLOADERROR] & @CRLF & _
            "@extended: " & $aData[$INET_DOWNLOADEXTENDED] & @CRLF)

    ; Supprime le fichier.
    FileDelete($sFilePath)
EndFunc   ;==>Example