次の方法で共有

サービス コンテンツの列挙

  • [アーティクル]

アプリケーションがサービスを開いた後、サービス関連の操作の実行を開始できます。 WpdServicesApiSample アプリケーションの場合、これらの操作の 1 つは、特定の連絡先サービスのコンテンツの列挙です。 次の表では、使用されるインターフェイスについて説明します。

インターフェイス 説明
IPortableDeviceService サービス上のコンテンツにアクセスするために IPortableDeviceContent2 インターフェイスを取得するために使用されます。
IPortableDeviceContent2 サービス上のオブジェクトを列挙するための IEnumPortableDeviceObjectIDs インターフェイスを取得するために使用されます。
IEnumPortableDeviceObjectIDs サービス上のオブジェクトを列挙するために使用されます。

 

コンテンツ列挙コードは ContentEnumeration.cpp モジュールにあります。 このコードは 、EnumerateAllContent メソッドと RecursiveEnumerate メソッドに存在します。 前者のメソッドは後者を呼び出します。

EnumerateContent メソッドは、IPortableDeviceService オブジェクトへのポインターを 1 つのパラメーターとして受け取ります。 このオブジェクトは、 アプリケーションが 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;
            }
        }
    }
}

IEnumPortableDeviceObjectIDs

IPortableDeviceContent2 インターフェイス

IPortableDeviceService インターフェイス

サービスを開く

WpdServicesApiSample