Metodo IRecordInfo::GetFieldNoCopy (oaidl.h)

Articolo
02/29/2024

Restituisce un puntatore al valore di un determinato nome di campo senza copiare il valore e allocare le risorse.

Sintassi

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

Parametri

[in] pvData

Istanza di un record.

[in] szFieldName

Nome del campo.

[out] pvarField

VALORE VARIANT che conterrà il tipo definito dall'utente al momento della restituzione.

[out] ppvDataCArray

Riceve il valore del campo al momento della restituzione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Uno o più argomenti non sono validi.

Commenti

Al termine della restituzione, l'oggetto VARIANT passato contiene un puntatore diretto al campo del record , ppvDataCArray. Se si modifica variant, il campo del record sottostante verrà modificato.

Il chiamante alloca la memoria di VARIANT, ma non è proprietaria della memoria, pertanto non può liberare pvarField. Questo metodo chiama VariantClear per pvarField prima di compilare il campo richiesto.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	oaidl.h

Vedi anche

IRecordInfo

VariantClear

Condividi tramite