Compartir a través de

función IUnknown_QueryService (shlwapi.h)

  • Artículo

Recupera una interfaz para un servicio de un objeto especificado.

Sintaxis

LWSTDAPI IUnknown_QueryService(
  [in]  IUnknown *punk,
  [in]  REFGUID  guidService,
  [in]  REFIID   riid,
  [out] void     **ppvOut
);

Parámetros

[in] punk

Tipo: IUnknown*

Puntero a la instancia IUnknown del objeto COM que admite el servicio.

[in] guidService

Tipo: REFGUID

Identificador único (SID) del servicio.

[in] riid

Tipo: REFIID

IiD de la interfaz de servicio deseada.

[out] ppvOut

Tipo: void**

Cuando este método vuelve, contiene el puntero de interfaz solicitado riid. Si se ejecuta correctamente, la aplicación que realiza la llamada es responsable de llamar a IUnknown::Release con este valor cuando el servicio ya no es necesario. En caso de error, este valor es NULL.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente. Devuelve E_FAIL si el objeto no admite IServiceProvider. De lo contrario, la función devuelve el VALOR HRESULT devuelto por el método QueryService del objeto.

Comentarios

Si el objeto pasado en el parámetro punk admite la interfaz IServiceProvider , se invoca su método QueryService , pasando los parámetros guidService, riid y ppvOut y propagando el valor devuelto. De lo contrario, la función devuelve E_FAIL.

Para las versiones de Windows que no incluyen IUnknown_QueryService en Shlwapi.h, se debe llamar a esta función directamente desde Shlwapi.dll mediante ordinal 176.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server, Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Archivo DLL Shlwapi.dll (versión 5.0 o posterior)

Consulte también

IServiceProvider

QueryService