IWMDMMetaData::GetItemCount 메서드(mswmdm.h)

아티클
02/29/2024

GetItemCount 메서드는 인터페이스에서 보유한 총 속성 수를 검색합니다.

구문

HRESULT GetItemCount(
  [out] UINT *iCount
);

매개 변수

[out] iCount

인터페이스에 의해 저장된 메타데이터 속성의 총 수를 수신하는 정수에 대한 포인터입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. Windows Media 장치 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스를 반환할 수 있습니다.

표준 COM 오류 코드
HRESULT 값으로 변환된 Windows 오류 코드
Windows Media 장치 관리자 오류 코드

가능한 오류 코드의 광범위한 목록은 오류 코드를 참조하세요.

설명

이 메서드는 QueryByIndex 와 함께 사용하여 스토리지 또는 디바이스의 모든 속성을 열거할 수 있습니다.

예제

다음 코드는 IWMDMMetaData 인터페이스(pMetadata)의 속성 수를 검색하고 인덱스로 모두 검색하여 인쇄하려고 시도합니다. 사용자 지정 오류 처리 매크로 BREAK_HR 사용합니다.


        //
        // Loop through all metadata properties, and print out the value of each.
        //
        BYTE* value;
        WMDM_TAG_DATATYPE type;
        UINT len = 0;
        UINT count = 0;
        WCHAR* name;
        // Get the number of metadata items.
        hr = pMetadata->GetItemCount(&count);

        BREAK_HR(hr, "Got a metadata count in GetMetadata.", "Couldn't get a metadata count in GetMetadata.");
        for(;count > 0; count--)
        {
            // Get the metadata property by index.
            WCHAR* name;
            hr = pMetadata->QueryByIndex(count-1, &name, &type, &value, &len);
            if (SUCCEEDED(hr))
            {
                // TODO: Display the property name.
                CoTaskMemFree(name);

                // Print out the value of the property, according to the value type.
                switch (type)
                {
                case WMDM_TYPE_QWORD:
                case WMDM_TYPE_DWORD:
                case WMDM_TYPE_WORD:
                    // TODO: Display the value.
                    break;
                case WMDM_TYPE_STRING:
                    // TODO: Display the value.
                    // Release the method-allocated property value memory.
                    if (SUCCEEDED(hr))
                        CoTaskMemFree(value);
                    break;
                case WMDM_TYPE_BOOL:
                    // TODO: Display the value.
                    break;
                case WMDM_TYPE_BINARY:
                    // TODO: Display the value.
                    break;
                case WMDM_TYPE_DATE:
                    {
                        WMDMDATETIME *val = (WMDMDATETIME*)value;
                        / /TODO: Display the month, day, and year.
                    }
                    break;
                case WMDM_TYPE_GUID:
                    {
                        WCHAR strGuid[64];
                        StringFromGUID2(reinterpret_cast<GUID&>(value),(LPOLESTR)strGuid, 64);
                        / /TODO: Display the GUID.
                    }
                    break;
                default:
                    // TODO: Display a message indicating that the 
                    // application could not understand the returned value type.
                }
            }
            else // Couldn't get the metadata property at index count - 1.
                // TODO: Display a message indicating that the 
                // application couldn't retrieve a value for the index.
        // Clear the WMDM-allocated memory.
        if (value)
            CoTaskMemFree(value);
        }