Método IPropertyBag::Read (oaidl.h)

Lee la propiedad con nombre en un VARIANT inicializado por el autor de la llamada.

Sintaxis

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

Parámetros

pszPropName

Dirección del nombre de la propiedad que se va a leer. No puede ser NULL.

pVar

Dirección del variant inicializado por el autor de la llamada que recibe el valor de propiedad en la salida. La función establece el campo de tipo y el campo de valor en variant antes de que devuelva. Si el autor de la llamada inicializó el campo en la pVar->vt entrada, el contenedor de propiedades intenta cambiar su valor correspondiente a este tipo. Si el autor de la llamada establece pVar->vt en VT_EMPTY, el contenedor de propiedades puede usar cualquier tipo que sea conveniente.

pErrorLog

La dirección del registro de errores del autor de la llamada en la que el contenedor de propiedades almacena los errores que se producen durante las lecturas. Puede ser NULL; en cuyo caso, el autor de la llamada no recibe errores.

Valor devuelto

Un HRESULT

Comentarios

El método Read indica al contenedor de propiedades que lea la propiedad denominada en pszPropName al variant inicializado del autor de la llamada en pVar. Los errores se registran en el registro de errores al que apunta pErrorLog. Cuando pVar->vt especifica otro puntero de objeto (VT_UNKNOWN), el contenedor de propiedades es responsable de crear e inicializar el objeto descrito por pszPropName.

E_NOTIMPL no es un código de retorno válido, ya que cualquier objeto que implemente esta interfaz debe admitir toda la funcionalidad de la interfaz.

Requisitos

Requisito	Value
Cliente mínimo compatible	compilación 20348 de Windows 10
Servidor mínimo compatible	compilación 20348 de Windows 10
Encabezado	oaidl.h