funzione IUnknown_QueryService (shlwapi.h)

  • Articolo

Recupera un'interfaccia per un servizio da un oggetto specificato.

Sintassi

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

Parametri

[in] punk

Tipo: IUnknown*

Puntatore all'istanza IUnknown dell'oggetto COM che supporta il servizio.

[in] guidService

Tipo: REFGUID

Identificatore univoco (SID) del servizio.

[in] riid

Tipo: REFIID

ID dell'interfaccia del servizio desiderata.

[out] ppvOut

Tipo: void**

Quando termina, questo metodo contiene il puntatore di interfaccia richiesto riid. In caso di esito positivo, l'applicazione chiamante è responsabile della chiamata a IUnknown::Release usando questo valore quando il servizio non è più necessario. In caso di errore, questo valore è NULL.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo. Restituisce E_FAIL se l'oggetto non supporta IServiceProvider. In caso contrario, la funzione restituisce il valore HRESULT restituito dal metodo QueryService dell'oggetto.

Commenti

Se l'oggetto passato nel parametro punk supporta l'interfaccia IServiceProvider , viene richiamato il relativo metodo QueryService , passando i parametri guidService, riid e ppvOut e propagando il valore restituito. In caso contrario, la funzione restituisce E_FAIL.

Per le versioni di Windows che non includono IUnknown_QueryService in Shlwapi.h, questa funzione deve essere chiamata direttamente da Shlwapi.dll usando ordinale 176.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato Windows 2000 Server, Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlwapi.h
DLL Shlwapi.dll (versione 5.0 o successiva)

Vedi anche

IServiceProvider

QueryService