Fungsi FsRtlMupGetProviderIdFromName (ntifs.h)

  • Artikel

Rutinitas FsRtlMupGetProviderIdFromName mendapatkan pengidentifikasi penyedia pengalihan jaringan yang terdaftar di beberapa penyedia UNC (MUP) dari nama perangkat pengalihan jaringan.

Sintaks

NTSTATUS FsRtlMupGetProviderIdFromName(
  [in]  PCUNICODE_STRING pProviderName,
  [out] PULONG32         pProviderId
);

Parameter

[in] pProviderName

Penunjuk ke string Unicode yang berisi nama perangkat pengalih jaringan.

[out] pProviderId

Penunjuk ke variabel berjenis ULONG32 yang menerima pengidentifikasi penyedia pengalihan jaringan.

Nilai kembali

Rutinitas FsRtlMupGetProviderIdFromName mengembalikan salah satu nilai NTSTATUS berikut.

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Pengidentifikasi penyedia pengalihan jaringan berhasil dikembalikan dalam variabel yang diarahkan oleh parameter pProviderId .
STATUS_INVALID_PARAMETER
 Salah satu parameternya adalah NULL.
STATUS_OBJECT_NAME_NOT_FOUND
 Nama pengalih jaringan yang ditentukan dalam parameter pProviderName tidak cocok dengan nama penyedia UNC yang terdaftar di MUP.

Keterangan

Driver filter sistem file dapat memanggil rutinitas FsRtlMupGetProviderIdFromName untuk mendapatkan pengidentifikasi penyedia pengalihan jaringan dari nama pengalih jaringan. Driver filter sistem file dapat dengan cepat membandingkan nilai pengidentifikasi ini dengan nilai pengidentifikasi penyedia lain tanpa perlu melakukan perbandingan string.

Nilai pengidentifikasi penyedia untuk pengalihan jaringan tertentu tetap sama jika pengalih jaringan dibongkar dari sistem dan kemudian dimuat ulang kembali ke dalam sistem.

Untuk mendapatkan pengidentifikasi penyedia pengalihan jaringan dari objek file, driver filter sistem file dapat memanggil rutinitas FsRtlMupGetProviderInfoFromFileObject .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Fungsi FsRtlMupGetProviderIdFromName adalah Windows Vista
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Lihat juga

FsRtlMupGetProviderInfoFromFileObject