Description des appareils

Il existe deux façons d’obtenir des objets d’appareil :

• Utilisation de l’interface IUPnPDescriptionDocument . L’interface IUPnPDescriptionDocument est la seule interface sécurisée pour les scripts.
• Utilisation de l’interface IUPnPDeviceFinder pour obtenir une interface IUPnPDevices .

Les deux méthodes retournent des collections d’appareils. Les applications utilisent ensuite les méthodes Device pour récupérer les propriétés relatives aux appareils.

Les applications peuvent récupérer les types d’informations suivants :

• Informations sur la hiérarchie des appareils, notamment les appareils racines, les appareils parents et les appareils enfants.
• Propriétés de l’appareil, y compris les noms DUD, les IDENTIFICATEURs de ressources uniformes (URI) et les noms lisibles par l’utilisateur.
• Informations du fabricant, y compris les noms et les pages Web associées.
• Informations sur le modèle, notamment le nom, le numéro, l’UPC, les numéros de série et les descriptions d’appareil.
• Affichez des informations, notamment l’URL pour contrôler l’appareil et les URL à partir desquelles les icônes sont téléchargées.
• Services fournis par un appareil particulier.

Les applications obtiennent également l’URL du document de description de l’appareil à l’aide de l’interface IUPnPDeviceDocumentAccess . L’application charge ensuite le document de description et travaille avec les propriétés d’appareil et de service qui ne sont pas exposées par l’interface IUPnPDevice . Cette interface ne peut pas être utilisée dans le script, car il ne s’agit pas de l’interface par défaut.

Exemple Visual Basic

L’exemple de code suivant montre l’utilisation de IUPnPDeviceDocumentAccess::GetDocumentURL.

Sub GetDocumentURL()
Dim pDescDoc As IUPnPDeviceDocumentAccess
Dim strDescDocURL As String

'currentDevice is UPnPDevice object containing the current UPnP Device 
'We are trying to get IUPnPDeviceDocumentAccess interface in the UPnP Device object
Set pDescDoc = currentDevice

If Not (pDescDoc is Nothing) Then
  'Description Document URL is got from device
  strDescDocURL = pDescDoc.GetDocumentURL 
End If

Exemple C++

L’exemple de code suivant montre l’utilisation de IUPnPDeviceDocumentAccess::GetDocumentURL.

#include <windows.h>
#include <upnp.h>
#include <stdio.h>

#pragma comment(lib, "ole32.lib")
#pragma comment(lib, "oleaut32.lib")

int GetDeviceDocumentUrl () 
{
  HRESULT hr = S_OK;
  // List of interfaces needed
  IUPnPDeviceFinder *pDevFinder=NULL;
  IUPnPDevice *pDevice =NULL;
  IUPnPDeviceDocumentAccess* pDeviceDocument=NULL;
  BSTR bstrDeviceUDN =NULL;
  BSTR bstrDeviceDocumentURL = NULL; 

  bstrDeviceUDN = SysAllocString(L"uuid:234324234324");
  if(bstrDeviceUDN == NULL){
    printf("ERROR: Could not allocate memory\n");
    return -1;
  }  

  //CoInitialize the program so that we can create COM objects
  CoInitializeEx(NULL, COINIT_MULTITHREADED);

  //now try to instantiate the DeviceFinder object
  hr = CoCreateInstance(  CLSID_UPnPDeviceFinder, 
              NULL,
              CLSCTX_INPROC_SERVER,
              IID_IUPnPDeviceFinder,
              (LPVOID *) &pDevFinder); 

  if(!SUCCEEDED(hr)){
    printf("\nERROR: CoCreateInstance on IUPnPDeviceFinder returned HRESULT %x",hr);
    goto cleanup;
  }

  printf("\nGot a pointer to the IUPnPDeviceFinder Interface");

  printf("\n Finding the device of given UDN\n");
  hr =pDevFinder->FindByUDN(bstrDeviceUDN, &pDevice);
  if(hr!=S_OK)
  {
    printf("\nERROR: FindByUDN for %S returned HRESULT %x", bstrDeviceUDN, hr);
    goto cleanup;
  }

  printf("\n\tFindByUDN for device of UDN %S succeeded", bstrDeviceUDN);
  //Now query pDevice for IUPnPDeviceDocumentAccess
  hr = pDevice->QueryInterface(IID_IUPnPDeviceDocumentAccess, (VOID **)&pDeviceDocument);
  if(SUCCEEDED(hr)){
    // We have got a pointer to the IUPnPDeviceDocumentAccess interface.
    // GetDocumentURL is available only in Windows XP. 
    hr = pDeviceDocument->GetDocumentURL(&bstrDeviceDocumentURL);
    if(SUCCEEDED(hr))
      printf("\nThe Device Document URL is %S \n", bstrDeviceDocumentURL);
  }
    
cleanup:
  //release references to all interfaces 
  if(pDevFinder)
    pDevFinder->Release();
  if(pDevice)
    pDevice->Release();
  if(pDeviceDocument)
    pDeviceDocument->Release();
  
  // Free the bstr strings
  if(bstrDeviceDocumentURL)
    SysFreeString(bstrDeviceDocumentURL);
  if(bstrDeviceUDN)
    SysFreeString(bstrDeviceUDN);
  CoUninitialize();
  return 0;
}