Bagikan melalui

Metode IXpsOMPage::GenerateUnusedLookupKey (xpsobjectmodel.h)

  • Artikel

Menghasilkan nama unik yang dapat digunakan sebagai kunci pencarian oleh sumber daya dalam kamus sumber daya.

Sintaks

HRESULT GenerateUnusedLookupKey(
  [in]          XPS_OBJECT_TYPE type,
  [out, retval] LPWSTR          *key
);

Parameter

[in] type

Jenis objek IXpsOMShareable yang kunci pencariannya dihasilkan.

[out, retval] key

String kunci pencarian yang dihasilkan oleh metode ini.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK; jika tidak, kode kesalahan HRESULT akan dikembalikan.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
E_POINTER
 kuncinya adalah NULL.
E_INVALIDARG
 jenis mengacu pada jenis objek yang tidak dikenali.

Keterangan

Agar unik dalam kamus, string yang dihasilkan oleh GenerateUnusedLookupKey terdiri dari string awalan yang didasarkan pada jenis objek dan diikuti oleh empat karakter alfanumerik unik.

String awalan untuk setiap jenis objek diperlihatkan dalam tabel berikut.

Tipe objek String awalan untuk tipe objek ini
XPS_OBJECT_TYPE_CANVAS Kanvas_
XPS_OBJECT_TYPE_GEOMETRY Geometri_
XPS_OBJECT_TYPE_GLYPHS Glyphs_
XPS_OBJECT_TYPE_IMAGE_BRUSH IBrush_
XPS_OBJECT_TYPE_LINEAR_GRADIENT_BRUSH LGBrush_
XPS_OBJECT_TYPE_MATRIX_TRANSFORM MTransform_
XPS_OBJECT_TYPE_PATH Jalan_
XPS_OBJECT_TYPE_RADIAL_GRADIENT_BRUSH RGBrush_
XPS_OBJECT_TYPE_SOLID_COLOR_BRUSH SCBrush_
XPS_OBJECT_TYPE_VISUAL_BRUSH VBrush_
 
Catatan  

Metode ini mengembalikan string kunci yang unik dalam konteks halaman ini. Tidak dijamin untuk mengembalikan kunci yang unik dalam sumber daya kamus jarak jauh yang dapat digunakan oleh lebih dari satu halaman.

 
Metode ini mengalokasikan memori yang digunakan oleh string yang dikembalikan dalam kunci. Jika kunci bukan NULL, gunakan fungsi CoTaskMemFree untuk membebaskan memori.

Persyaratan

   
Klien minimum yang didukung Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header xpsobjectmodel.h

Lihat juga

IXpsOMPage

Spesifikasi Kertas XML

XPS_OBJECT_TYPE