Método CBaseDispatch.GetIDsOfNames

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O GetIDsOfNames método mapeia um conjunto de nomes para um conjunto correspondente de DISPIDs.

Sintaxe

HRESULT GetIDsOfNames(
   REFIID  riid,
   OLECHAR **rgszNames,
   UINT    cNames,
   LCID    lcid,
   DISPID  *rgdispid
);

Parâmetros

riid

Referência a um IID (identificador de interface) que especifica a interface .

rgszNames

Endereço de uma matriz de cadeias de caracteres largos que contêm os nomes a serem mapeados.

Cnames

Tamanho da matriz fornecida pelo parâmetro rgszNames .

lcid

Contexto de localidade no qual interpretar os nomes. Pode ser NULL.

rgdispid

Ponteiro para uma matriz que recebe os DISPIDs. Cada elemento de recebe um identificador que corresponde a um dos nomes passados no parâmetro rgszNames .

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno	Descrição
S_OK	Êxito.
E_OUTOFMEMORY	Memória insuficiente.
DISP_E_UNKNOWNNAME	Um ou mais nomes não eram conhecidos.

Comentários

Esse método se comporta como o método IDispatch::GetIDsOfNames , mas o parâmetro riid especifica a interface na qual recuperar DISPIDs. (Na versão IDispatch , o parâmetro riid é reservado.)

Se o método retornar DISP_E_UNKNOWNNAME, os DISPIDs retornados conterão DISPID_UNKNOWN para cada entrada que corresponde a um nome desconhecido.

Requisitos

Requisito	Valor
parâmetro	Ctlutil.h (inclua Streams.h)
Biblioteca	Strmbase.lib (builds de varejo); Strmbasd.lib (builds de depuração)

Confira também

Classe CBaseDispatch