Método IRecordInfo::P utField (oaidl.h)

Artigo
02/29/2024

Coloca uma variante em um campo.

Sintaxe

HRESULT PutField(
  [in]      ULONG     wFlags,
  [in, out] PVOID     pvData,
  [in]      LPCOLESTR szFieldName,
  [in]      VARIANT   *pvarField
);

Parâmetros

[in] wFlags

Os únicos valores legais para o parâmetro wFlags são INVOKE_PROPERTYPUT ou INVOKE_PROPERTYPUTREF.

Se INVOKE_PROPERTYPUTREF for passada, PutField apenas atribuirá o valor da variante que é passada para o campo usando regras normais de coerção.

Se INVOKE_PROPERTYPUT for passada, as regras específicas se aplicarão. Se o campo for declarado como uma classe derivada de IDispatch e o valor do campo for NULL, um erro será retornado. Se o valor do campo não for NULL, a variante será passada para a propriedade padrão com suporte pelo objeto referenciado pelo campo. Se o campo não for declarado como uma classe derivada de IDispatch , um erro será retornado. Se o campo for declarado como uma variante do tipo VT_Dispatch, o valor padrão do objeto será atribuído ao campo. Caso contrário, o valor da variante será atribuído ao campo .

[in, out] pvData

O ponteiro para uma instância do registro.

[in] szFieldName

O nome do campo do registro.

[in] pvarField

O ponteiro para a variante.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
E_INVALIDARG	Um ou mais argumentos não são válidos.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	oaidl.h

Confira também

IRecordInfo

Compartilhar via