FsRtlMupGetProviderIdFromName 함수(ntifs.h)

FsRtlMupGetProviderIdFromName 루틴은 네트워크 리디렉터의 디바이스 이름에서 여러 UNC 공급자(MUP)에 등록된 네트워크 리디렉터의 공급자 식별자를 가져옵니다.

통사론

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

매개 변수

[in] pProviderName

네트워크 리다이렉터의 디바이스 이름을 포함하는 유니코드 문자열에 대한 포인터입니다.

[out] pProviderId

네트워크 리디렉터의 공급자 식별자를 수신하는 ULONG32 형식 변수에 대한 포인터입니다.

반환 값

FsRtlMupGetProviderIdFromName 루틴은 다음 NTSTATUS 값 중 하나를 반환합니다.

반환 코드	묘사
STATUS_SUCCESS	pProviderId 매개 변수가 가리키는 변수에서 네트워크 리디렉터의 공급자 식별자가 성공적으로 반환되었습니다.
STATUS_INVALID_PARAMETER	매개 변수 중 하나는 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