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

Artigo
08/24/2023

O método IADsExtension::P rivateInvoke normalmente é chamado por ADSI após o método IADsExtension::P rivateGetIDsOfNames . Esse método pode ter uma implementação personalizada ou pode delegar a operação ao método IDispatch::D ispInvoke .

Sintaxe

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

Parâmetros

[in] dispidMember

Identifica o membro. Use o método IADsExtension::P rivateGetIDsOfNames para obter o identificador de expedição.

[in] riid

Reservado para uso futuro. Deve ser IID_NULL.

[in] lcid

O contexto de localidade no qual interpretar argumentos. A função IADsExtension::P rivateGetIDsOfNames usa lcid. Ele também é passado para o método PrivateInvoke para permitir que o objeto interprete os argumentos específicos de uma localidade.

[in] wFlags

Os sinalizadores que descrevem o contexto da chamada PrivateInvoke incluem.

DISPATCH_METHOD

O membro é invocado como um método . Se uma propriedade tiver o mesmo nome, esse e o sinalizador DISPATCH_PROPERTYGET poderão ser definidos.

DISPATCH_PROPERTYGET

O membro é recuperado como uma propriedade ou membro de dados.

DISPATCH_PROPERTYPUT

O membro é alterado como uma propriedade ou membro de dados.

DISPATCH_PROPERTYPUTREF

O membro é alterado por uma atribuição de referência, em vez de uma atribuição de valor. Esse sinalizador é válido somente quando a propriedade aceita uma referência a um objeto .

[in] pdispparams

Ponteiro para uma estrutura DISPPARAMS que recebe uma matriz de argumentos, uma matriz de DISPIDs de argumento para argumentos nomeados e contagens para o número de elementos nas matrizes.

[out] pvarResult

Ponteiro para o local onde o resultado deve ser armazenado ou NULL se o chamador não espera nenhum resultado. Esse argumento será ignorado se DISPATCH_PROPERTYPUT ou DISPATCH_PROPERTYPUTREF for especificado.

[out] pexcepinfo

Ponteiro para uma estrutura que contém dados de exceção. Essa estrutura deverá ser preenchida se DISP_E_EXCEPTION for retornado. Pode ser NULL.

[out] puArgErr

O índice dentro do membro rgvarg da estrutura DISPPARAMS em pdispparams para o primeiro argumento que tem um erro. Os argumentos são armazenados na matriz rgvarg em ordem inversa, portanto, o primeiro argumento é aquele com o índice mais alto na matriz. Esse parâmetro é retornado somente quando o valor retornado resultante é DISP_E_TYPEMISMATCH ou DISP_E_PARAMNOTFOUND.

Retornar valor

Esse método dá suporte aos valores retornados padrão, bem como aos seguintes.

Para obter mais informações sobre outros valores retornados, consulte Códigos de erro ADSI.

Requisitos

Requisito	Valor
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