列舉服務內容
應用程式開啟服務之後,即可開始執行服務相關的作業。 在 WpdServicesApiSample 應用程式的情況下,其中一項作業是針對指定的聯繫人服務進行內容列舉。 下表描述所使用的介面。
介面 | 描述 |
---|---|
IPortableDeviceService | 用來擷取 IPortableDeviceContent2 介面,以存取服務上的內容。 |
IPortableDeviceContent2 | 用來擷取 IEnumPortableDeviceObjectIDs 介面,以列舉服務上的物件。 |
IEnumPortableDeviceObjectIDs | 用來列舉服務上的物件。 |
內容列舉程式代碼位於 ContentEnumeration.cpp 模組中。 此程式代碼位於 EnumerateAllContent 和 RecursiveEnumerate 方法中。 先前的方法會呼叫後者。
EnumerateContent 方法會使用指向 IPortableDeviceService 物件的指標作為其一個參數。 當應用程式呼叫 IPortableDeviceService::Open 方法時,這個對象會對應至應用程式稍早開啟的服務。
EnumerateContent 方法會建立 IPortableDeviceContent2 物件,並將這個對象傳遞至 IPortableDeviceService::Content 方法。 這個方法接著會擷取服務根層級的內容,然後遞歸開始擷取根底下找到的內容。
下列程式代碼對應至方法 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);
}
}
下列程式碼對應至 RecursiveEnumerate 方法。 RecursiveEnumerate 方法會具現化所提供父物件的 IEnumPortableDeviceObjectIDs 介面,並呼叫 IEnumPortableDeviceObjectIDs::Next,擷取一批立即子物件。 針對每個子物件,會再次呼叫 RecursiveEnumerate 以傳回其子代子物件等等。
// 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;
}
}
}
}
相關主題