Share via

FsRtlMupGetProviderIdFromName 関数 (ntifs.h)

  • [アーティクル]

FsRtlMupGetProviderIdFromName ルーチンは、ネットワーク リダイレクターのデバイス名から、複数の UNC プロバイダー (MUP) に登録されているネットワーク リダイレクターのプロバイダー識別子を取得します。

構文

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

パラメーター

[in] pProviderName

ネットワーク リダイレクターのデバイス名を含む Unicode 文字列へのポインター。

[out] pProviderId

ネットワーク リダイレクターのプロバイダー識別子を受け取るULONG32型指定された変数へのポインター。

戻り値

FsRtlMupGetProviderIdFromName ルーチンは、次のいずれかの NTSTATUS 値を返します。

リターン コード 説明
STATUS_SUCCESS
 ネットワーク リダイレクターのプロバイダー識別子が、 pProviderId パラメーターによって指されている変数で正常に返されました。
STATUS_INVALID_PARAMETER
 パラメーターの 1 つが NULL です。
STATUS_OBJECT_NAME_NOT_FOUND
 pProviderName パラメーターで指定されたネットワーク リダイレクターの名前が、MUP に登録されている UNC プロバイダーの名前と一致しません。

注釈

ファイル システム フィルター ドライバーは 、FsRtlMupGetProviderIdFromName ルーチンを呼び出して、ネットワーク リダイレクターの名前からネットワーク リダイレクターのプロバイダー識別子を取得できます。 ファイル システム フィルター ドライバーは、文字列比較を行うことなく、この識別子の値を他のプロバイダー識別子の値とすばやく比較できます。

特定のネットワーク リダイレクターのプロバイダー識別子の値は、ネットワーク リダイレクターがシステムからアンロードされた後、システムに再読み込みされた場合でも変わりません。

ファイル オブジェクトからネットワーク リダイレクターのプロバイダー識別子を取得するには、ファイル システム フィルター ドライバーは FsRtlMupGetProviderInfoFromFileObject ルーチンを呼び出すことができます。

要件

要件 値
サポートされている最小のクライアント FsRtlMupGetProviderIdFromName 関数は Windows Vista です
対象プラットフォーム ユニバーサル
Header ntifs.h (Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL <= APC_LEVEL

こちらもご覧ください

FsRtlMupGetProviderInfoFromFileObject