PSGetPropertyDescriptionByName 함수(propsys.h)

  • 아티클

지정된 속성 이름에 대한 속성 설명 인터페이스의 instance 가져옵니다.

구문

PSSTDAPI PSGetPropertyDescriptionByName(
  [in]  LPCWSTR pszCanonicalName,
  [in]  REFIID  riid,
  [out] void    **ppv
);

매개 변수

[in] pszCanonicalName

형식: LPCWSTR

속성을 식별하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in] riid

형식: REFIID

요청된 속성의 인터페이스 ID에 대한 참조입니다.

[out] ppv

형식: void**

이 함수가 반환되면 는 riid에서 요청된 인터페이스 포인터를 포함합니다. 일반적으로 IPropertyDescription, IPropertyDescriptionAliasInfo 또는 IPropertyDescriptionSearchInfo입니다.

반환 값

형식: PSSTDAPI

다음 값 중 하나를 반환합니다.

반환 코드 설명
S_OK
 인터페이스를 얻었습니다.
E_INVALIDARG
 pszCanonicalName 매개 변수는 NULL입니다.
TYPE_E_ELEMENTNOTFOUND
 정식 이름은 스키마 하위 시스템 캐시에 없습니다.

설명

objbase.h에 정의된 IID_PPV_ARGS 매크로를 사용하여 riid 및 ppv 매개 변수를 패키지하는 것이 좋습니다. 이 매크로는 ppv의 값이 가리키는 인터페이스를 기반으로 올바른 IID를 제공하여 코딩 오류의 가능성을 제거합니다.

pszCanonicalName은 속성의 정식 이름(예L"System.Keywords": )을 가리키는 것이 좋습니다. 정식 이름은 대/소문자를 구분합니다.

호출자는 새 정식 이름 외에도 속성에 대한 레거시 이름을 전달할 수 있습니다. 다음 표에는 지원되는 레거시 이름 및 해당하는 정식 이름의 전체 목록이 포함되어 있습니다.

속성 이름 속성에 매핑
Access System.DateAccessed
Album System.Music.AlbumTitle
AllocSize System.FileAllocationSize
조리개 System.Photo.Aperture
Artist System.Music.Artist
Attrib System.FileAttributes
특성 System.FileAttributes
AttributesDescription System.FileAttributesDisplay
오디오 형식 System.Audio.Format
오디오 샘플 크기 System.Audio.SampleSize
BitDepth System.Image.BitDepth
Bitrate System.Audio.EncodingBitrate
CameraModel System.Photo.CameraModel
용량 System.Capacity
채널 System.Audio.ChannelCount
ColorSpace System.Image.ColorSpace
회사 System.Company
압축 System.Video.Compression
압축 System.Video.Compression
Copyright System.Copyright
Copyright System.Copyright
Copyright System.Image.Copyright
생성 System.DateCreated
CSCStatus System.OfflineStatus
데이터 속도 System.Video.EncodingBitrate
DateDeleted System.Recycle.DateDeleted
DeletedFrom System.Recycle.DeletedFrom
차원 System.Image.Dimensions
디렉터리 System.ItemFolderNameDisplay
거리 System.Photo.SubjectDistance
DocAppName System.ApplicationName
DocAuthor System.Author
DocByteCount System.Document.ByteCount
DocCategory System.Category
DocCharCount System.Document.CharacterCount
DocComments System.Comment
DocCompany System.Company
DocCreatedTm System.Document.DateCreated
DocEditTime System.Document.TotalEditingTime
DocHiddenCount System.Document.HiddenSlideCount
DocKeywords System.Keywords
DocLastAuthor System.Document.LastAuthor
DocLastPrinted System.Document.DatePrinted
DocLastSavedTm System.Document.DateSaved
DocLineCount System.Document.LineCount
DocManager System.Document.Manager
DocNoteCount System.Document.NoteCount
DocPageCount System.Document.PageCount
DocParaCount System.Document.ParagraphCount
DocPresentationTarget System.Document.PresentationFormat
DocRevNumber System.Document.RevisionNumber
DocSlideCount System.Document.SlideCount
DocSubject System.Subject
DocTemplate System.Document.Template
DocTitle System.Title
DocWordCount System.Document.WordCount
DRM 설명 System.DRM.Description
Duration System.Media.Duration
EquipMake System.Photo.CameraManufacturer
ExposureBias System.Photo.ExposureBias
ExposureProg System.Photo.ExposureProgram
ExposureTime System.Photo.ExposureTime
FaxCallerID System.Fax.CallerID
FaxCSID System.Fax.CSID
FaxRecipientName System.Fax.RecipientName
FaxRecipientNumber System.Fax.RecipientNumber
팩스 경로 지정 System.Fax.Routing
FaxSenderName System.Fax.SenderName
FaxTime System.Fax.Time
FaxTSID System.Fax.TSID
FileDescription System.FileDescription
FileSystem System.Volume.FileSystem
FileType System.Image.FileType
FileVersion System.FileVersion
깜박임 System.Photo.Flash
FlashEnergy System.Photo.FlashEnergy
FNumber System.Photo.FNumber
FocalLength System.Photo.FocalLength
프레임 속도 System.Video.FrameRate
FrameCount System.Media.FrameCount
FreeSpace System.FreeSpace
Genre System.Music.Genre
ImageX System.Image.HorizontalSize
Imagey System.Image.VerticalSize
ISOSpeed System.Photo.ISOSpeed
LightSource System.Photo.LightSource
LinksUpToDate System.Document.LinksDirty
LinkTarget System.Link.TargetParsingPath
Lyrics System.Music.Lyrics
Manager System.Document.Manager
MeteringMode System.Photo.MeteringMode
MMClipCount System.Document.MultimediaClipCount
Name System.ItemNameDisplay
소유자 System.FileOwner
재생 횟수 System.DRM.PlayCount
재생 만료 System.DRM.DatePlayExpires
재생 시작 System.DRM.DatePlayStarts
PresentationTarget System.Document.PresentationFormat
ProductName System.Software.ProductName
ProductVersion System.Software.ProductVersion
프로젝트 System.Media.Project
보호됨 System.DRM.IsProtected
순위 System.Search.Rank
등급 System.Rating
ResolutionX System.Image.HorizontalResolution
해결 방법 System.Image.VerticalResolution
샘플링 주기 System.Audio.SampleRate
확장 System.Document.Scale
셔터스피드 System.Photo.ShutterSpeed
크기 System.Size
소프트웨어 System.SoftwareUsed
상태 System.Media.Status
상태 System.Status
스트림 이름 System.Video.StreamName
SyncCopyIn System.Sync.CopyIn
Track System.Music.TrackNumber
Type System.ItemTypeText
비디오 샘플 크기 System.Video.SampleSize
WhenTaken System.Photo.DateTaken
쓰기 System.DateModified
Year System.Media.Year
 

예제

더 큰 프로그램의 일부로 포함할 다음 예제에서는 PSGetPropertyDescriptionByName 을 사용하여 ratings 속성에 대한 설명을 검색하는 방법을 보여 줍니다.

IPropertyDescription *pPropDesc;

HRESULT hr = PSGetPropertyDescriptionByName(L"System.Rating", IID_PPV_ARGS(&pPropDesc))

if (SUCCEEDED(hr))
{
    // pPropDesc is now valid.
 
    pPropDesc->Release();
}

요구 사항

   
지원되는 최소 클라이언트 WINDOWS XP SP2, Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 WINDOWS Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 propsys.h
라이브러리 Propsys.lib
DLL Propsys.dll(버전 5.0 이상)
재배포 가능 파일 WDS(Windows 데스크톱 검색) 3.0

추가 정보

IPropertySystem

PSGetPropertyDescription