Metode IFunctionDiscovery::GetInstance (functiondiscoveryapi.h)

Artikel
02/28/2024

[Penemuan Fungsi tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Mendapatkan instans fungsi yang ditentukan, berdasarkan pengidentifikasi.

Sintaks

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

Parameter

[in] pszFunctionInstanceIdentity

Pengidentifikasi instans fungsi (lihat GetID).

[out] ppIFunctionInstance

Penunjuk ke penunjuk antarmuka IFunctionInstance yang digunakan untuk mengembalikan antarmuka.

Nilai kembali

Kemungkinan nilai yang dikembalikan termasuk, tetapi tidak terbatas pada, berikut ini.

Mengembalikan kode/nilai	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_INVALIDARG	Nilai pszFunctionInstanceIdentity tidak valid.
E_OUTOFMEMORY	Metode tidak dapat mengalokasikan memori yang diperlukan untuk melakukan operasi ini.
HRESULT_FROM_WIN32(ERROR_OBJECT_NOT_FOUND) 0x800710d8	Instans fungsi yang diwakili oleh ID yang ditentukan tidak ada pada komputer ini.
E_PENDING	Panggilan dijalankan untuk penyedia yang mengembalikan hasil secara asinkron.

Keterangan

Beberapa penyedia penemuan fungsi mengembalikan hasil kueri mereka dengan antarmuka IFunctionDiscoveryNotification . GetInstance tidak menemukan instans fungsi yang dikembalikan dengan cara ini dan akan gagal dengan E_PENDING. Disarankan agar klien menggunakan metode CreateInstanceQuery dari antarmuka IFunctionDiscovery untuk menemukan instans fungsi untuk penyedia tersebut.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	functiondiscoveryapi.h
DLL	FunDisc.dll

Lihat juga

IFunctionDiscovery

Share via