次の方法で共有

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 です
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

関連項目

FsRtlMupGetProviderInfoFromFileObject