Compartilhar via

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

  • Artigo

Obtém os nomes dos campos do registro.

Sintaxe

HRESULT GetFieldNames(
  [in, out] ULONG *pcNames,
  [out]     BSTR  *rgBstrNames
);

Parâmetros

[in, out] pcNames

O número de nomes a serem retornados.

[out] rgBstrNames

O nome da matriz do tipo BSTR.

Se o parâmetro rgBstrNames for NULL, pcNames será retornado com o número de nomes de campo.

Ele o parâmetro rgBstrNames não é NULL e, em seguida, os nomes de cadeia de caracteres contidos em rgBstrNames são retornados . Se o número de nomes em pcNames e rgBstrNames não for igual, o número menor dos dois será o número de nomes de campo retornados. O chamador precisa liberar os BSTRs dentro da matriz retornada em rgBstrNames.

Valor retornado

Esse método pode retornar um desses valores.

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

Comentários

O chamador deve alocar memória para a matriz de BSTRs. Se a matriz for maior do que o necessário, defina a parte não usada como 0.

No retorno, o chamador precisará liberar cada BSTR contido usando SysFreeString.

Em caso de falta de memória, pcNames aponta para o código de erro.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho oaidl.h

Confira também

IRecordInfo

Sysfreestring