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

Retourne un pointeur vers la valeur d’un nom de champ donné sans copier la valeur et allouer des ressources.

Syntaxe

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

Paramètres

[in] pvData

Instance d’un enregistrement.

[in] szFieldName

Nom du champ.

[out] pvarField

VARIANT qui contiendra l’UDT au retour.

[out] ppvDataCArray

Reçoit la valeur du champ lors du retour.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Réussite.
E_INVALIDARG
Un ou plusieurs arguments ne sont pas valides.

Remarques

Au retour, le VARIANT que vous passez contient un pointeur direct vers le champ de l’enregistrement, ppvDataCArray. Si vous modifiez le variant, le champ d’enregistrement sous-jacent change.

L’appelant alloue la mémoire du VARIANT, mais n’est pas propriétaire de la mémoire et ne peut donc pas libérer pvarField. Cette méthode appelle VariantClear pour pvarField avant de remplir le champ demandé.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête oaidl.h

Voir aussi

IRecordInfo

VariantClear