MÉTHODE IADsExtension::P rivateGetIDsOfNames (iads.h)

Article
08/24/2023

La méthode IADsExtension::P rivateGetIDsOfNames est appelée par l’agrégateur, ADSI, une fois qu’ADSI a déterminé que l’extension est utilisée pour prendre en charge une interface double ou de répartition. La méthode peut utiliser les données de type pour obtenir DISPID à l’aide de IDispatch::GetIDsOfNames.

Syntaxe

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

Paramètres

riid

Réservé pour un usage futur. Il doit être IID_NULL.

rgszNames

Tableau passé des noms à mapper.

cNames

Compte des noms à mapper.

lcid

Contexte des paramètres régionaux dans lequel interpréter les noms.

rgDispid

Tableau alloué par l’appelant, chaque élément de contenant un identificateur qui correspond à l’un des noms passés dans le tableau rgszNames . Le premier élément représente le nom du membre. Les éléments suivants représentent chacun des paramètres du membre.

Valeur retournée

Les valeurs de retour sont les mêmes que celles de la méthode IDispatch::GetIDsOfNames standard. Pour plus d’informations sur les autres valeurs de retour, consultez Codes d’erreur ADSI.

Notes

Tous les paramètres ont la même signification que ceux correspondants dans la norme IDispatch::GetIDsOfNames(). Le composant d’extension retourne un identificateur unique (rgDispID) pour chaque méthode ou propriété définie dans les interfaces doubles prises en charge. L’unicité est appliquée dans le composant d’extension. Le fournisseur ADSI doit garantir l’unicité des DISPID de tous les objets d’extension et de l’agrégateur (ADSI) lui-même. Le paramètre rgDispID doit être compris entre 1 et 16777215 (2^24-1) ou -1 (DISPID_UNKNOWN).

Exemples

L’exemple de code C/C++ suivant montre une implémentation générique de cette méthode.

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

Configuration requise


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