Método IADsExtension::P rivateGetIDsOfNames (iads.h)

Artigo
08/24/2023

O método IADsExtension::P rivateGetIDsOfNames é chamado pelo agregador, ADSI, depois que ADSI determina que a extensão é usada para dar suporte a uma interface dupla ou de expedição. O método pode usar os dados de tipo para obter DISPID usando IDispatch::GetIDsOfNames.

Sintaxe

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

Parâmetros

riid

Reservado para uso futuro. Deve ser IID_NULL.

rgszNames

Matriz passada de nomes a serem mapeados.

cNames

Contagem dos nomes a serem mapeados.

lcid

O contexto de localidade no qual interpretar os nomes.

rgDispid

Matriz alocada pelo chamador, cada elemento do qual contém um identificador que corresponde a um dos nomes passados na matriz rgszNames . O primeiro elemento representa o nome do membro. Os elementos subsequentes representam cada um dos parâmetros do membro.

Valor retornado

Os valores retornados são os mesmos do método IDispatch::GetIDsOfNames padrão. Para obter mais informações sobre outros valores retornados, consulte Códigos de erro ADSI.

Comentários

Todos os parâmetros têm o mesmo significado que os correspondentes no IDispatch::GetIDsOfNames(). O componente de extensão retorna um identificador exclusivo (rgDispID) para cada método ou propriedade definida nas interfaces duplas com suporte. A exclusividade é imposta dentro do componente de extensão. O provedor ADSI deve garantir a exclusividade dos DISPIDs de todos os objetos de extensão e do agregador (ADSI) em si. O parâmetro rgDispID deve estar entre 1 e 16777215 (2^24-1) ou -1 (DISPID_UNKNOWN).

Exemplos

O exemplo de código C/C++ a seguir mostra uma implementação genérica desse método.

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

Requisitos


Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	iads.h
DLL	Activeds.dll