Fungsi MrmIndexFile

[Beberapa informasi berkaitan dengan produk pra-rilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersurat atau tersirat, sehubungan dengan informasi yang diberikan di sini.]

Mengindeks file sumber daya milik aplikasi UWP. Mengambil daftar kualifikasi sumber daya yang eksplisit (tetapi opsional). Untuk informasi selengkapnya, dan panduan berbasis skenario tentang cara menggunakan API ini, lihat API pengindeksan sumber daya paket (PRI) dan sistem build kustom.

Sintaks

HRESULT HRESULT MrmIndexFile(
  _In_     MrmResourceIndexerHandle indexer,
  _In_     PCWSTR                   resourceUri,
  _In_     PCWSTR                   filePath,
  _In_opt_ PCWSTR                   qualifiers
);

Parameter

indexer [in]

Jenis: MrmResourceIndexerHandle

Handel yang mengidentifikasi pengindeks sumber daya yang akan mengindeks file sumber daya.

resourceUri [in]

Jenis: PCWSTR

URI sumber daya untuk ditetapkan ke sumber daya. Jalur akan digunakan sebagai nama subtree peta sumber daya untuk sumber daya ini ketika Anda nantinya membuat file PRI dari pengindeks sumber daya ini.

filePath [in]

Jenis: PCWSTR

Jalur relatif ke file yang berisi sumber daya yang ingin Anda indeks. Jalur ini relatif terhadap akar proyek aplikasi UWP tempat Anda menghasilkan file PRI. Akar proyek tersebut adalah nilai projectRoot yang Anda berikan ke MrmCreateResourceIndexer.

kualifikasi [in, opsional]

Jenis: PCWSTR

Daftar opsional kualifikasi sumber daya, misalnya L"language-en-US_scale-100_contrast-standard". String kosong atau nullptr menunjukkan sumber daya netral. Kualifikasi sumber daya tidak disimpulkan dari resourceUri atau dari containerPath.

Menampilkan nilai

Jenis: HRESULT

S_OK jika fungsi berhasil, jika tidak, beberapa nilai lainnya. Gunakan makro SUCCEEDED() atau FAILED() (ditentukan dalam winerror.h) untuk menentukan keberhasilan atau kegagalan.

Keterangan

Jika Anda ingin menentukan kualifikasi sumber daya apa pun, teruskan dalam parameter kualifikasi . Kualifikasi sumber daya tidak disimpulkan dari resourceUri atau dari filePath.

Segmen nama file resourceUri (bukan filePath) digunakan sebagai nama sumber daya.

Persyaratan

Lihat juga

API pengindeksan sumber daya paket (PRI) dan sistem build kustom