Share via

IRecordInfo::GetFieldNames 메서드(oaidl.h)

  • 아티클

레코드 필드의 이름을 가져옵니다.

구문

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

매개 변수

[in, out] pcNames

반환할 이름 수입니다.

[out] rgBstrNames

BSTR 형식의 배열 이름입니다.

rgBstrNames 매개 변수가 NULL이면 pcNames가 필드 이름 수와 함께 반환됩니다.

rgBstrNames 매개 변수가 NULL이 아닌 경우 rgBstrNames에 포함된 문자열 이름이 반환됩니다. pcNames 및 rgBstrNames의 이름 수가 같지 않으면 반환된 필드 이름 수가 두 개보다 적습니다. 호출자는 rgBstrNames로 반환된 배열 내에서 BSTR을 해제해야 합니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
S_OK
 성공.
E_OUT_OFMEMORY
 메모리가 부족합니다.
E_INVALIDARG
하나 이상의 인수가 잘못되었습니다.

설명

호출자는 BSTR 배열에 대한 메모리를 할당해야 합니다. 배열이 필요 이상으로 크면 사용되지 않는 부분을 0으로 설정합니다.

반환 시 호출자는 SysFreeString을 사용하여 포함된 각 BSTR을 해제해야 합니다.

메모리가 부족할 경우 pcNames는 오류 코드를 가리킵니다.

요구 사항

   
대상 플랫폼 Windows
헤더 oaidl.h

추가 정보

IRecordInfo

SysFreeString