Enumerando conteúdo do serviço
Depois que o aplicativo abrir um serviço, ele poderá começar a executar operações relacionadas ao serviço. No caso do aplicativo WpdServicesApiSample, uma dessas operações é a enumeração de conteúdo para um determinado serviço Contacts. A tabela a seguir descreve as interfaces usadas.
Interface | Descrição |
---|---|
IPortableDeviceService | Usado para recuperar a interface IPortableDeviceContent2 para acessar o conteúdo no serviço. |
IPortableDeviceContent2 | Usado para recuperar a interface IEnumPortableDeviceObjectIDs para enumerar objetos no serviço. |
IEnumPortableDeviceObjectIDs | Usado para enumerar objetos no serviço. |
O código de enumeração de conteúdo é encontrado no módulo ContentEnumeration.cpp. Esse código reside nos métodos EnumerateAllContent e RecursiveEnumerate . O método anterior chama o último.
O método EnumerateContent usa um ponteiro para um objeto IPortableDeviceService como seu único parâmetro. Esse objeto corresponde a um serviço que o aplicativo abriu anteriormente quando chamou o método IPortableDeviceService::Open .
O método EnumerateContent cria um objeto IPortableDeviceContent2 e passa esse objeto para o método IPortableDeviceService::Content . Esse método, por sua vez, recupera o conteúdo no nível raiz do serviço e, em seguida, começa recursivamente a recuperar o conteúdo encontrado abaixo da raiz.
O código a seguir corresponde ao método EnumerateContent .
// Enumerate all content on the service starting with the
// "DEVICE" object
void EnumerateAllContent(
IPortableDeviceService* pService)
{
HRESULT hr = S_OK;
CComPtr<IPortableDeviceContent2> pContent;
if (pService == NULL)
{
printf("! A NULL IPortableDeviceService interface pointer was received\n");
return;
}
// Get an IPortableDeviceContent2 interface from the IPortableDeviceService interface to
// access the content-specific methods.
hr = pService->Content(&pContent);
if (FAILED(hr))
{
printf("! Failed to get IPortableDeviceContent2 from IPortableDeviceService, hr = 0x%lx\n",hr);
}
// Enumerate content starting from the "DEVICE" object.
if (SUCCEEDED(hr))
{
printf("\n");
RecursiveEnumerate(WPD_DEVICE_OBJECT_ID, pContent);
}
}
O código a seguir corresponde ao método RecursiveEnumerate . O método RecursiveEnumerate cria uma instância de uma interface IEnumPortableDeviceObjectIDs para o objeto pai fornecido e chama IEnumPortableDeviceObjectIDs::Next, recuperando um lote de objetos filho imediatos. Para cada objeto filho, RecursiveEnumerate é chamado novamente para retornar seus objetos filho descendentes e assim por diante.
// Recursively called function which enumerates using the specified
// object identifier as the parent.
void RecursiveEnumerate(
PCWSTR pszObjectID,
IPortableDeviceContent2* pContent)
{
CComPtr<IEnumPortableDeviceObjectIDs> pEnumObjectIDs;
// Print the object identifier being used as the parent during enumeration.
printf("%ws\n",pszObjectID);
// Get an IEnumPortableDeviceObjectIDs interface by calling EnumObjects with the
// specified parent object identifier.
HRESULT hr = pContent->EnumObjects(0, // Flags are unused
pszObjectID, // Starting from the passed in object
NULL, // Filter is unused
&pEnumObjectIDs);
if (FAILED(hr))
{
printf("! Failed to get IEnumPortableDeviceObjectIDs from IPortableDeviceContent2, hr = 0x%lx\n",hr);
}
// Loop calling Next() while S_OK is being returned.
while(hr == S_OK)
{
DWORD cFetched = 0;
PWSTR szObjectIDArray[NUM_OBJECTS_TO_REQUEST] = {0};
hr = pEnumObjectIDs->Next(NUM_OBJECTS_TO_REQUEST, // Number of objects to request on each NEXT call
szObjectIDArray, // Array of PWSTR array which will be populated on each NEXT call
&cFetched); // Number of objects written to the PWSTR array
if (SUCCEEDED(hr))
{
// Traverse the results of the Next() operation and recursively enumerate
// Remember to free all returned object identifiers using CoTaskMemFree()
for (DWORD dwIndex = 0; dwIndex < cFetched; dwIndex++)
{
RecursiveEnumerate(szObjectIDArray[dwIndex],pContent);
// Free allocated PWSTRs after the recursive enumeration call has completed.
CoTaskMemFree(szObjectIDArray[dwIndex]);
szObjectIDArray[dwIndex] = NULL;
}
}
}
}
Tópicos relacionados