IADsExtension：:P rivateGetIDsOfNames 方法 (iads.h)

發行項
08/24/2023

IADsExtension：:P rivateGetIDsOfNames方法是由匯總工具 ADSI 呼叫，在 ADSI 判斷擴充功能是用來支援雙重或分派介面。方法可以使用類型資料，使用 IDispatch：：GetIDsOfNames 取得 DISPID。

語法

HRESULT PrivateGetIDsOfNames(
  REFIID       riid,
  OLECHAR      **rgszNames,
  unsigned int cNames,
  LCID         lcid,
  DISPID       *rgDispid
);

參數

riid

保留供未來使用。它必須IID_Null。

rgszNames

要對應之傳入的名稱陣列。

cNames

要對應的名稱計數。

lcid

用於解譯名稱的地區設定內容。

rgDispid

呼叫端配置的陣列，其中每個元素都包含一個識別碼，對應至 rgszNames 陣列中傳遞的其中一個名稱。第一個專案代表成員名稱。後續元素代表每個成員的參數。

傳回值

傳回值與標準 IDispatch：：GetIDsOfNames 方法的傳回值相同。如需其他傳回值的詳細資訊，請參閱 ADSI 錯誤碼。

備註

所有參數都與標準 IDispatch：：GetIDsOfNames () 中的對應參數具有相同意義。擴充元件會針對支援雙重介面中定義的每個方法或屬性傳回唯一識別碼 (rgDispID) 。擴充元件內會強制執行唯一性。 ADSI 提供者必須確定所有擴充物件的 DISPID 唯一性，以及匯總工具 (ADSI) 本身。 rgDispID參數必須介於 1 到 16777215 (2^24-1) 之間，或 -1 (DISPID_UNKNOWN) 。

範例

下列 C/C++ 程式碼範例示範此方法的泛型實作。

STDMETHOD(PrivateGetIDsOfNames)(REFIID riid, OLECHAR ** rgszNames, unsigned int cNames, LCID lcid, DISPID  * rgdispid)
{
  if (rgdispid == NULL)
  {
     return E_POINTER;
  }
  return  DispGetIDsOfNames(m_pTypeInfo, rgszNames, cNames, rgdispid);
}