Metode IFunctionDiscovery::GetInstance (functiondiscoveryapi.h)

[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

  • Last updated on