Metodo IFunctionDiscoveryProviderFactory::CreateInstance (functiondiscoveryprovider.h)

[L'individuazione delle funzioni è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Crea un'istanza della funzione. Tutte le istanze di funzione devono essere create usando questo metodo. Non è consigliabile usare altre implementazioni che supportano IFunctionInstance .

Sintassi

HRESULT CreateInstance(
  [in]  const WCHAR                *pszSubCategory,
  [in]  const WCHAR                *pszProviderInstanceIdentity,
  [in]  INT_PTR                    iProviderInstanceContext,
  [in]  IPropertyStore             *pIPropertyStore,
  [in]  IFunctionDiscoveryProvider *pIFunctionDiscoveryProvider,
  [out] IFunctionInstance          **ppIFunctionInstance
);

Parametri

[in] pszSubCategory

Stringa di sottocategoria per l'istanza della funzione. Vedere Definizioni di sottocategoria.

[in] pszProviderInstanceIdentity

Identificatore dell'istanza del provider.

L'individuazione delle funzioni usa questo identificatore per garantire che gli identificatori dell'istanza di funzione restituiti da IFunctionInstance::GetID siano univoci. A tale scopo, l'individuazione funzione associa un prefisso all'identificatore passato a pszProviderInstanceIdentity per garantire che un identificatore di istanza di funzione specificato sia univoco in tutti i provider. Gli implementatori devono solo assicurarsi che pszProviderInstanceIdentity identifichi in modo univoco il dispositivo, la risorsa o l'istanza all'interno dell'ambito del provider.

Questa stringa viene restituita alle applicazioni client che chiamano IFunctionInstance::GetProviderInstanceID.

Non esiste alcun limite massimo per le dimensioni di questa stringa.

[in] iProviderInstanceContext

Contesto associato all'istanza della funzione specifica.

[in] pIPropertyStore

Puntatore a un'interfaccia IPropertyStore .

[in] pIFunctionDiscoveryProvider

Puntatore all'istanza del provider IFunctionDiscoveryProvider che crea questa istanza della funzione.

[out] ppIFunctionInstance

Puntatore a un'interfaccia IFunctionInstance .

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il provider deve specificare la sottocategoria (può essere NULL), l'identificatore dell'istanza, un contesto allocato dal provider (se necessario) e un archivio proprietà facoltativo.

CreateInstance restituisce un'istanza della funzione inizializzata in modo appropriato al provider.

Il contesto specificato dal provider verrà passato al provider per tutti i metodi correlati all'istanza di funzione successiva, ad esempio InstanceReleased, InstancePropertyStoreOpen, InstancePropertyStoreFlush e InstanceQueryService.

Il provider deve garantire che il numero di riferimenti del provider non vada a zero, possibilmente in un altro thread, mentre viene chiamata CreateInstance .

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	functiondiscoveryprovider.h

Vedi anche

IFunctionDiscoveryProviderFactory