Metodo IFunctionInstance::GetID (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 la stringa di identificatore per l'istanza della funzione. Questo identificatore può essere salvato e usato in un secondo momento per eseguire nuovamente una query per la stessa istanza di funzione tramite IFunctionDiscovery::GetInstance.

Sintassi

HRESULT GetID(
  [out] WCHAR **ppszCoMemIdentity
);

Parametri

[out] ppszCoMemIdentity

Stringa di identificatore dell'istanza della funzione. Non esiste alcun limite massimo per le dimensioni di questa stringa.

Questa stringa è una stringa composta generata dall'individuazione delle funzioni. Ha la stringa di identificatore dell'istanza del provider come sottostringa. Per altre informazioni sugli identificatori del provider, vedere IFunctionInstance::GetProviderInstanceID.

Per le istanze di funzione restituite da un provider predefinito, questo identificatore è garantito identificare in modo univoco una risorsa in un sistema, anche se la risorsa viene disconnessa e riconnessa. Per le istanze di funzione restituite dai provider personalizzati, l'identificatore dell'istanza di funzione è univoco se il provider ha un identificatore del provider univoco.

Questo identificatore non deve essere modificato o prodotto a livello di codice. La stringa deve essere usata solo per recuperare istanze di funzione e per scopi di confronto.

Assicurarsi di liberare questo buffer usando CoTaskMemFree.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_INVALIDARG	Il valore di ppszCoMemID non è valido.
E_OUTOFMEMORY	Il metodo non è in grado di allocare la memoria necessaria per eseguire questa operazione.

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

IFunctionInstance