IPerPropertyBrowsing::GetPredefinedValue 메서드(ocidl.h)

미리 정의된 문자열 이름과 연결된 지정된 속성의 값을 검색합니다. 이 속성은 IPerPropertyBrowsing::GetPredefinedStrings에서 반환된 미리 정의된 문자열 이름과 연결됩니다. 미리 정의된 문자열은 GetPredefinedStrings에서 반환된 토큰으로 식별됩니다.

구문

HRESULT GetPredefinedValue(
  [in]  DISPID  dispID,
  [in]  DWORD   dwCookie,
  [out] VARIANT *pVarOut
);

매개 변수

[in] dispID

미리 정의된 값이 요청되는 속성의 디스패치 식별자입니다.

[in] dwCookie

반환할 값을 식별하는 토큰입니다. 토큰은 이전에 GetPredefinedStrings로 채워진 pCaCookiesOut 배열에서 반환되었습니다.

[out] pVarOut

속성의 VARIANT 값에 대한 포인터입니다.

반환 값

이 메서드는 다음 값뿐만 아니라 E_INVALIDARG, E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값을 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 완료되었습니다.
E_NOTIMPL	이 개체는 미리 정의된 문자열 또는 미리 정의된 값을 지원하지 않습니다.
E_POINTER	pVarOut의 주소가 잘못되었습니다. 예를 들어 NULL일 수 있습니다.

설명

발신자에 대한 참고 사항

호출자는 VARIANT에 포함된 모든 할당을 해제해야 합니다. VARIANT의 vt 멤버가 VT_VARIANT 않는 한 호출자는 VariantClear에 대한 단일 호출을 사용하여 메모리를 해제할 수 있습니다. 그렇지 않으면 호출자는 외부 VARIANT를 해제하기 전에 포함된 VARIANT 값을 재귀적으로 해제해야 합니다.

구현자에 대한 참고 사항

미리 정의된 이름 및 값에 대한 지원은 필요하지 않습니다. 개체가 이러한 이름을 지원하지 않는 경우 이 메서드에서 E_NOTIMPL 반환합니다. 이 메서드가 구현되지 않은 경우 IPerPropertyBrowsing::GetPredefinedStrings 도 구현하면 안 됩니다.

이 메서드는 VARIANT 내에 필요한 모든 메모리를 할당합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ocidl.h

추가 정보

IPerPropertyBrowsing