Método ITypeInfo::GetDllEntry (oaidl.h)

Recupera uma descrição ou especificação de um ponto de entrada de uma função em uma DLL.

Sintaxe

HRESULT GetDllEntry(
  [in]  MEMBERID   memid,
  [in]  INVOKEKIND invKind,
  [out] BSTR       *pBstrDllName,
  [out] BSTR       *pBstrName,
  [out] WORD       *pwOrdinal
);

Parâmetros

[in] memid

A ID da função de membro cuja descrição de entrada da DLL será retornada.

[in] invKind

O tipo de membro identificado por memid. Isso é importante para propriedades, pois um memid pode identificar até três funções separadas.

[out] pBstrDllName

Se não for nulo, a função definirá pBstrDllName como o nome da DLL.

[out] pBstrName

Se não for nulo, a função definirá pBstrName como o nome do ponto de entrada. Se o ponto de entrada for especificado por um ordinal, esse argumento será nulo.

[out] pwOrdinal

Se não for nulo e se a função for definida por um ordinal, a função definirá pwOrdinal como ordinal.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_INVALIDARG
Um ou mais argumentos não são válidos.
E_OUTOFMEMORY
Memória insuficiente para concluir a operação.

Comentários

O chamador passa uma ID de membro, que representa a função membro cuja descrição de entrada é desejada. Se a função tiver um ponto de entrada DLL, o nome da DLL que contém a função, bem como seu nome ou identificador ordinal, será colocado nos ponteiros passados alocados pelo chamador. Se não houver nenhum ponto de entrada de DLL para a função, um erro será retornado.

Se a descrição do tipo herdar de outra descrição de tipo, essa função será recursiva à descrição do tipo base, se necessário, para localizar o item com a ID de membro solicitada.

O chamador deve usar SysFreeString para liberar os BSTRs referenciados por pBstrName e pBstrDllName.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho oaidl.h

Confira também

ITypeInfo