Método CBaseDispatch.GetIDsOfNames

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetIDsOfNames método asigna un conjunto de nombres a un conjunto correspondiente de DISPIDs.

Sintaxis

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

Parámetros

riid

Referencia a un identificador de interfaz (IID) que especifica la interfaz.

rgszNames

Dirección de una matriz de cadenas de caracteres anchos que contienen los nombres que se van a asignar.

cNames

Tamaño de la matriz dada por el parámetro rgszNames .

lcid

Contexto de configuración regional en el que se interpretan los nombres. Puede ser NULL.

rgdispid

Puntero a una matriz que recibe los DISPID. Cada elemento de recibe un identificador que corresponde a uno de los nombres pasados en el parámetro rgszNames .

Valor devuelto

Devuelve un valor HRESULT . Estos son algunos de los valores posibles.

Código devuelto Descripción
S_OK
 Correcto.
E_OUTOFMEMORY
 Memoria insuficiente.
DISP_E_UNKNOWNNAME
 No se conocían uno o varios de los nombres.

Observaciones

Este método se comporta como el método IDispatch::GetIDsOfNames , pero el parámetro riid especifica la interfaz en la que recuperar DISPIDs. (En la versión IDispatch , el parámetro riid está reservado).

Si el método devuelve DISP_E_UNKNOWNNAME, los DISPID devueltos contienen DISPID_UNKNOWN para cada entrada que corresponde a un nombre desconocido.

Requisitos

Requisito Value
Encabezado
Ctlutil.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CBaseDispatch (clase)