IFunctionInstance::Metode GetID (functiondiscoveryapi.h)

  • Artikel

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

Mendapatkan string pengidentifikasi untuk instans fungsi. Pengidentifikasi ini dapat disimpan dan kemudian digunakan untuk mengkueri ulang instans fungsi yang sama melalui IFunctionDiscovery::GetInstance.

Sintaks

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

Parameter

[out] ppszCoMemIdentity

String pengidentifikasi instans fungsi. Tidak ada batas atas pada ukuran string ini.

String ini adalah untai (karakter) yang dibuat oleh Penemuan Fungsi. Ini memiliki string pengidentifikasi instans penyedia sebagai substring. Untuk informasi selengkapnya tentang pengidentifikasi penyedia, lihat IFunctionInstance::GetProviderInstanceID.

Untuk instans fungsi yang dikembalikan oleh penyedia bawaan, pengidentifikasi ini dijamin untuk mengidentifikasi sumber daya secara unik pada sistem, bahkan jika sumber daya terputus dan terhubung kembali. Untuk instans fungsi yang dikembalikan oleh penyedia kustom, pengidentifikasi instans fungsi unik jika penyedia memiliki pengidentifikasi penyedia unik.

Pengidentifikasi ini tidak boleh dimanipulasi atau diproduksi secara terprogram. String hanya boleh digunakan untuk mengambil instans fungsi dan untuk tujuan perbandingan.

Pastikan untuk membebaskan buffer ini menggunakan CoTaskMemFree.

Nilai kembali

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

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.
E_INVALIDARG
 Nilai ppszCoMemID tidak valid.
E_OUTOFMEMORY
 Metode tidak dapat mengalokasikan memori yang diperlukan untuk melakukan operasi ini.

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

IFunctionInstance