ITypeInfo：：GetNames 方法 (oaidl.h)

  • 發行項

擷取具有指定成員標識碼的變數，或是屬性或方法的名稱，以及對應至指定函式標識碼的參數。

語法

HRESULT GetNames(
  [in]  MEMBERID memid,
  [out] BSTR     *rgBstrNames,
  [in]  UINT     cMaxNames,
  [out] UINT     *pcNames
);

參數

[in] memid

要傳回其名稱之成員的 ID。

[out] rgBstrNames

呼叫端配置的陣列。 傳回時，每個元素都包含與成員相關聯的名稱 (或名稱) 。

[in] cMaxNames

傳入 rgBstrNames 陣列的長度。

[out] pcNames

rgBstrNames 陣列中的名稱數目。

傳回值

這個方法可以傳回其中一個值。

傳回碼 Description
S_OK
成功。
E_INVALIDARG
一或多個自變數無效。
E_OUTOFMEMORY
記憶體不足，無法完成作業。

備註

呼叫端必須釋放傳回的 BSTR 陣列。

如果成員標識碼識別使用屬性函式實作的屬性，則會傳回屬性名稱。 對於屬性 get 函式，一律會傳回函式的名稱及其參數。

對於屬性放置和放置參考函式，指派的右側未命名。 如果 cMaxNames 小於 需要傳回函式參數的所有名稱，則只會傳回第一個 cMaxNames - 1 個參數的名稱。 參數的名稱會以與 (介面中其他位置相同的順序傳回參數名稱，例如，與 FUNCDESC 列舉) 相關聯的參數數位順序相同。

如果類型描述繼承自另一個類型描述，則此函式會視需要遞歸至基底類型描述，以尋找具有要求成員標識符的專案。

規格需求

需求 值
目標平台 Windows
標頭 oaidl.h

另請參閱

ITypeInfo