Metodo IFunctionDiscovery::GetInstance (functiondiscoveryapi.h)

[Individuazione funzioni è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Ottiene l'istanza di funzione specificata, in base all'identificatore.

Sintassi

HRESULT GetInstance(
  [in]  const WCHAR       *pszFunctionInstanceIdentity,
  [out] IFunctionInstance **ppIFunctionInstance
);

Parametri

[in] pszFunctionInstanceIdentity

Identificatore dell'istanza della funzione (vedere GetID).

[out] ppIFunctionInstance

Puntatore a un puntatore all'interfaccia IFunctionInstance usato per restituire l'interfaccia.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati a, quanto segue.

Codice/valore restituito	Descrizione
S_OK	Metodo completato correttamente.
E_INVALIDARG	Il valore di pszFunctionInstanceIdentity non è valido.
E_OUTOFMEMORY	Il metodo non è in grado di allocare la memoria necessaria per eseguire questa operazione.
HRESULT_FROM_WIN32(ERROR_OBJECT_NOT_FOUND) 0x800710d8	L'istanza della funzione rappresentata dall'ID specificato non esiste nel computer.
E_PENDING	La chiamata è stata eseguita per un provider che restituisce i risultati in modo asincrono.

Commenti

Alcuni provider di individuazione delle funzioni restituiscono i risultati della query con l'interfaccia IFunctionDiscoveryNotification . GetInstance non trova istanze di funzione restituite in questo modo e avrà esito negativo con E_PENDING. È consigliabile che i client usino il metodo CreateInstanceQuery dell'interfaccia IFunctionDiscovery per trovare istanze di funzione per tali provider.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	functiondiscoveryapi.h
DLL	FunDisc.dll

Vedi anche

IFunctionDiscovery