IADsExtension ::P rivateInvoke, méthode (iads.h)

Article
02/28/2024

La méthode IADsExtension ::P rivateInvoke est normalement appelée par ADSI après la méthode IADsExtension ::P rivateGetIDsOfNames . Cette méthode peut avoir une implémentation personnalisée ou déléguer l’opération à la méthode IDispatch ::D ispInvoke .

Syntaxe

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
);

Paramètres

[in] dispidMember

Identifie le membre. Utilisez la méthode IADsExtension ::P rivateGetIDsOfNames pour obtenir l’identificateur de dispatch.

[in] riid

Réservé à un usage ultérieur. Doit être IID_NULL.

[in] lcid

Contexte des paramètres régionaux dans lequel interpréter les arguments. La fonction IADsExtension ::P rivateGetIDsOfNames utilise lcid. Elle est également passée à la méthode PrivateInvoke pour permettre à l’objet d’interpréter les arguments spécifiques à un paramètre régional.

[in] wFlags

Indicateurs qui décrivent le contexte de l’appel PrivateInvoke , include.

DISPATCH_METHOD

Le membre est appelé en tant que méthode. Si une propriété porte le même nom, cet indicateur et l’indicateur DISPATCH_PROPERTYGET peuvent être définis.

DISPATCH_PROPERTYGET

Le membre est récupéré en tant que membre de propriété ou de données.

DISPATCH_PROPERTYPUT

Le membre est modifié en tant que membre de propriété ou de données.

DISPATCH_PROPERTYPUTREF

Le membre est modifié par une affectation de référence, plutôt que par une affectation de valeur. Cet indicateur est valide uniquement lorsque la propriété accepte une référence à un objet .

[in] pdispparams

Pointeur vers une structure DISPPARAMS qui reçoit un tableau d’arguments, un tableau de DISPIDs d’arguments pour les arguments nommés et le nombre d’éléments dans les tableaux.

[out] pvarResult

Pointeur vers l’emplacement où le résultat doit être stocké, ou NULL si l’appelant n’attend aucun résultat. Cet argument est ignoré si DISPATCH_PROPERTYPUT ou DISPATCH_PROPERTYPUTREF est spécifié.

[out] pexcepinfo

Pointeur vers une structure qui contient des données d’exception. Cette structure doit être remplie si DISP_E_EXCEPTION est retourné. Peut être NULL.

[out] puArgErr

Index dans le membre rgvarg de la structure DISPPARAMS dans pdispparams pour le premier argument qui a une erreur. Les arguments étant stockés dans le tableau rgvarg dans l’ordre inverse, le premier argument est celui qui a l’index le plus élevé dans le tableau. Ce paramètre est retourné uniquement lorsque la valeur de retour résultante est DISP_E_TYPEMISMATCH ou DISP_E_PARAMNOTFOUND.

Valeur retournée

Cette méthode prend en charge les valeurs de retour standard, ainsi que les éléments suivants.

Pour plus d’informations sur les autres valeurs de retour, consultez Codes d’erreur ADSI.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	iads.h
DLL	Activeds.dll