Compartir a través de

Método IRecordInfo::GetFieldNoCopy (oaidl.h)

  • Artículo

Devuelve un puntero al valor de un nombre de campo determinado sin copiar el valor y asignar recursos.

Sintaxis

HRESULT GetFieldNoCopy(
  [in]  PVOID     pvData,
  [in]  LPCOLESTR szFieldName,
  [out] VARIANT   *pvarField,
  [out] PVOID     *ppvDataCArray
);

Parámetros

[in] pvData

Instancia de un registro.

[in] szFieldName

Nombre del campo.

[out] pvarField

Variant que contendrá el UDT tras la devolución.

[out] ppvDataCArray

Recibe el valor del campo al devolverlo.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
E_INVALIDARG
Uno o varios de los argumentos no son válidos.

Comentarios

Tras la devolución, la VARIANT que se pasa contiene un puntero directo al campo del registro, ppvDataCArray. Si modifica variant, el campo de registro subyacente cambiará.

El autor de la llamada asigna memoria de VARIANT, pero no posee la memoria, por lo que no puede liberar pvarField. Este método llama a VariantClear para pvarField antes de rellenar el campo solicitado.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado oaidl.h

Consulte también

IRecordInfo

VariantClear