Lorsque vous créez une application personnalisée pour Windows Home Server, vous pouvez obtenir des informations sur les ordinateurs clients (également nommés « ordinateurs domestiques ») reliés au réseau de Windows Home Server. L'API de Windows Home Server vous permet d'écrire du code destiné à extraire des informations concernant les ordinateurs clients afin de les utiliser dans votre application personnalisée.
Propriétés des ordinateurs clients
Un ordinateur client individuel est représenté en tant qu'objet IComputerInfo et est doté des propriétés en lecture seule suivantes :
- Nom
- Texte descriptif
- Système d'exploitation
- Adresse IP
- État de la connexion (en ligne ou hors connexion)
Exemple d'ordinateur client
Étape 1. Créez une instance de WHSInfoClass.
Comme pour la plupart des objets de l'API de Windows Home Server, avant d'extraire des informations concernant les ordinateurs clients vous devez créer une instance de WHSInfoClass, comme suit :
WHSInfoClass pInfo = new WHSInfoClass();
Étape 2. Invoquez la méthode GetClientComputerInfo().
Il s'agit de la méthode WHSInfoClass qui permet d'obtenir des informations sur les ordinateurs clients. Elle renvoie un tableau d'objets IComputerInfo représentant l'ensemble des ordinateurs clients du réseau :
Array comps = pInfo.GetClientComputerInfo();
Étape 3. Parcourez le tableau en boucle.
Dans la mesure où la méthode GetClientComputerInfo ne renvoie qu'un tableau d'objets IComputerInfo, il vous faut parcourir l'intégralité du tableau en boucle pour obtenir des informations concernant un ordinateur client précis :
foreach (IComputerInfo pComp in comps)
{
Console.WriteLine("Computer: {0}" + pComp.ComputerName);
Console.WriteLine("Description: {0}" + pComp.Description);
Console.WriteLine("IPAddress: {0}" + pComp.IPAddress);
Console.WriteLine("IsOnline: {0}" + pComp.IsOnline);
Console.WriteLine("OS: {0}" + pComp.OperatingSystem);
}
Vous pouvez recourir à cette approche chaque fois que vous manipulez des ordinateurs clients via l'API de Windows Home Server.
SDK Windows Home Server et ordinateurs clients
Le Kit de développement logiciel Windows Home Server ne doit être utilisé que sur le serveur domestique. En effet, il n'est pas pris en charge sur les ordinateurs clients. Vous pouvez néanmoins obtenir des informations sur les relations entre un ordinateur client et Windows Home Server, par le biais des entrées du Registre de l'ordinateur client.
Pour déterminer si le connecteur Windows Home Server est installé sur l'ordinateur client, recherchez la valeur Version, de type chaîne, dans la clé de registre HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Home Server. Ne vérifiez pas seulement la présence de la clé, mais également de cette valeur : la clé peut subsister après la désinstallation du connecteur.
Si vous souhaitez modifier le comportement de votre application en fonction de l'état de la sauvegarde sur l'ordinateur client, vérifiez la valeur de BackupEnabled dans la clé de registre HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Home Server. Si cette valeur est de 1, l'ordinateur client est sauvegardé sur Windows Home Server. Si elle est différente de 1, l'ordinateur client n'est pas sauvegardé. Avant de vérifier si l'ordinateur client est sauvegardé, assurez-vous que le connecteur est installé.
Voir aussi