DispGetIDsOfNames

Artigo
09/09/2008

Windows Mobile Supported Windows Embedded CE Supported

9/8/2008

Essa função usa informações tipo para converter um conjunto de nomes para DISPIDs.

Syntax

HRESULT DispGetIDsOfNames(
  ItypeInfo* ptinfo, 
  OLECHAR FAR* FAR* rgszNames, 
  unsigned int cNames, 
  DISPID FAR* rgdispid 
);

Parameters

ptinfo
[no] Ponteiro para informações de tipo para uma interface. Informações esse tipo é específicas para uma interface e codificar linguagem, portanto, não é necessário para transmitir um identificador interface (IID) ou LCID para esta função.

rgszNames
[no] Matriz de seqüências Nome que pode ser o mesmo matriz passada para DispInvoke in a DISPPARAMS estrutura.

Se cNames é maior que 1, o nome é interpretado como um nome método e nomes subseqüentes são interpretados como parâmetros para esse método.

cNames
[no] Número de elementos rgszNames.

rgdispid
[out] Ponteiro para uma matriz de DISPIDs que devem ser preenchidas por essa função.

O primeiro identificador corresponde ao nome do método. Identificadores subseqüentes são interpretados como parâmetros para o método.

Return Value

Retorna os valores HRESULT mostrados a seguinte tabela.

Valor	Descrição
S_OK	A interface é com suporte.
E_INVALIDARG	Um argumento é inválido.
DISP_E_UNKNOWNNAME	Um ou mais nomes fornecido não eram conhecidas. A matriz retornada de DISPIDs contém DISPID_UNKNOWN para cada entrada que corresponde a um nome desconhecido.
Outros códigos de retorno	Qualquer ITypeInfo::Invoke erro pode ser retornado.

Remarks

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

Example

A função membro implementa esta codificar de Points.cpp arquivo de exemplo de linhas GetIDsOfNames para a classe CPoints usar DispGetIDsOfNames.

STDMETHODIMP
CPoints::GetIDsOfNames(
  REFIID riid,
  char FAR* FAR* rgszNames,
  UINT cNames,
  LCID lcid,
  DISPID FAR* rgdispid)
{
  return DispGetIDsOfNames(m_ptinfo, rgszNames, cNames, rgdispid);
}

Requirements

Header	oleauto.h
Library	oleaut32.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

Compartilhar via