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
다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
인터페이스를 얻었습니다. |
|
pszCanonicalName 매개 변수는 NULL입니다. |
|
정식 이름은 스키마 하위 시스템 캐시에 없습니다. |
설명
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 |