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