IMFAttributes::GetAllocatedString 메서드(mfobjects.h)

  • 아티클

키와 연결된 와이드 문자열을 가져옵니다. 이 메서드는 문자열에 대한 메모리를 할당합니다.

구문

HRESULT GetAllocatedString(
  [in]  REFGUID guidKey,
  [out] LPWSTR  *ppwszValue,
  [out] UINT32  *pcchLength
);

매개 변수

[in] guidKey

검색할 값을 식별하는 GUID입니다. 특성 형식은 MF_ATTRIBUTE_STRING 합니다.

[out] ppwszValue

키가 있고 값이 문자열 형식인 경우 이 매개 변수는 문자열의 복사본을 받습니다. 호출자는 CoTaskMemFree를 호출하여 문자열의 메모리를 해제해야 합니다.

[out] pcchLength

종결 NULL 문자를 제외한 문자열의 문자 수를 받습니다. 이 매개 변수는 NULL이 아니어야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드 Description
S_OK
 메서드가 성공했습니다.
MF_E_ATTRIBUTENOTFOUND
 지정된 키를 찾을 수 없습니다.
MF_E_INVALIDTYPE
 특성 값은 문자열이 아닙니다.

설명

문자열 값을 호출자가 할당한 버퍼에 복사하려면 IMFAttributes::GetString 메서드를 사용합니다.

이 인터페이스는 Windows Media Format 11 SDK 재배포 가능 구성 요소가 설치된 경우 다음 플랫폼에서 사용할 수 있습니다.

  • WINDOWS XP SP2(서비스 팩 2) 이상
  • KB900325(Windows XP Media Center Edition 2005) 및 KB925766(Windows XP Media Center Edition용 2006년 10월 업데이트 롤업)이 설치된 Windows XP Media Center Edition 2005.
참고 이전 버전의 설명서에서는 pcchLength 매개 변수가 NULL일 수 있다고 잘못 설명했습니다. 이 매개 변수를 NULL 로 설정하면 경우에 따라 성공할 수 있지만 보장되지는 않습니다. 호출자는 이 매개 변수에 대해 NULL 이 아닌 포인터를 전달해야 합니다.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 mfobjects.h(Mfidl.h 포함)
라이브러리 Mfuuid.lib

추가 정보

특성 및 속성

IMFAttributes

MF_ATTRIBUTE_TYPE