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

發行項
03/09/2024

在 IADsExtension：:P :PrivateGetIOfNames 方法之後，ADSI 通常會呼叫 IADsExtension：:P rivateGetIDsOfNames 方法。這個方法可以有自定義實作，也可以將作業委派給 IDispatch：:D ispInvoke 方法。

語法

HRESULT PrivateInvoke(
  [in]  DISPID       dispidMember,
  [in]  REFIID       riid,
  [in]  LCID         lcid,
  [in]  WORD         wFlags,
  [in]  DISPPARAMS   *pdispparams,
  [out] VARIANT      *pvarResult,
  [out] EXCEPINFO    *pexcepinfo,
  [out] unsigned int *puArgErr
);

參數

[in] dispidMember

辨識成員。使用 IADsExtension：:P rivateGetIDsOfNames 方法來取得分派標識符。

[in] riid

保留供未來使用。必須是 IID_NULL。

[in] lcid

地區設定內容，用於解譯引數。 IADsExtension：:P rivateGetIDsOfNames 函式會使用 lcid。它也會傳遞至 PrivateInvoke 方法，以允許對象解譯地區設定特有的自變數。

[in] wFlags

描述 PrivateInvoke 呼叫內容的旗標包括。

DISPATCH_METHOD

成員會叫用為方法。如果屬性具有相同的名稱，可能會設定這個和 DISPATCH_PROPERTYGET 旗標。

DISPATCH_PROPERTYGET

成員會擷取為屬性或數據成員。

DISPATCH_PROPERTYPUT

成員會變更為屬性或數據成員。

DISPATCH_PROPERTYPUTREF

成員會由參考指派變更，而不是值指派。只有當屬性接受對象的參考時，這個旗標才有效。

[in] pdispparams

接收自變數陣列的 DISPPARAMS 結構的指標、具名自變數的自變數 DISPID 陣列，以及數位中元素數目的計數。

[out] pvarResult

要儲存結果的位置指標，如果呼叫端預期沒有結果，則為 NULL 。如果指定 DISPATCH_PROPERTYPUT 或 DISPATCH_PROPERTYPUTREF ，則會忽略此自變數。

[out] pexcepinfo

包含例外狀況數據之結構的指標。如果傳回 DISP_E_EXCEPTION ，則應該填入此結構。可以是 NULL。

[out] puArgErr

pdispparams 中 DISPPARAMS 結構之 rgvarg 成員內的索引，代表發生錯誤的第一個自變數。自變數會以反向順序儲存在 rgvarg 陣列中，因此第一個自變數是陣列中索引最高的自變數。只有在產生的傳回值 DISP_E_TYPEMISMATCH 或 DISP_E_PARAMNOTFOUND時，才會傳回此參數。