IPropertyBag::Read 메서드(oaidl.h)

명명된 속성을 호출자 초기화된 VARIANT로 읽습니다.

구문

HRESULT Read(
  LPCOLESTR pszPropName,
  VARIANT   *pVar,
  IErrorLog *pErrorLog
);

매개 변수

pszPropName

읽을 속성 이름의 주소입니다. NULL일 수 없습니다.

pVar

출력에서 속성 값을 수신하는 호출자 초기화된 VARIANT의 주소입니다. 함수는 반환하기 전에 VARIANT의 형식 필드와 값 필드를 설정합니다. 호출자가 항목에서 pVar->vt 필드를 초기화한 경우 속성 모음은 해당 값을 이 형식으로 변경하려고 시도합니다. 호출자가 VT_EMPTY 설정 pVar->vt 하면 속성 모음은 편리한 형식을 사용할 수 있습니다.

pErrorLog

속성 모음이 읽기 중에 발생하는 오류를 저장하는 호출자의 오류 로그 주소입니다. NULL일 수 있습니다. 이 경우 호출자는 오류를 수신하지 않습니다.

반환 값

Hresult

설명

Read 메서드는 pszPropName에서 라는 속성을 pVar의 호출자 초기화된 VARIANT로 읽도록 속성 모음에 지시합니다. 오류는 pErrorLog가 가리키는 오류 로그에 기록됩니다. 다른 개체 포인터(VT_UNKNOWN)를 지정하는 경우 pVar->vt 속성 모음은 pszPropName에서 설명하는 개체를 만들고 초기화합니다.

이 인터페이스를 구현하는 모든 개체가 인터페이스의 전체 기능을 지원해야 하므로 E_NOTIMPL 올바른 반환 코드가 아닙니다.

요구 사항