Compartir a través de

Función FsRtlMupGetProviderIdFromName (ntifs.h)

  • Artículo

La rutina FsRtlMupGetProviderIdFromName obtiene el identificador de proveedor de un redirector de red registrado con el proveedor UNC múltiple (MUP) del nombre de dispositivo del redirector de red.

Sintaxis

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

Parámetros

[in] pProviderName

Puntero a una cadena Unicode que contiene el nombre del dispositivo del redirector de red.

[out] pProviderId

Puntero a una variable de tipo ULONG32 que recibe el identificador de proveedor del redirector de red.

Valor devuelto

La rutina FsRtlMupGetProviderIdFromName devuelve uno de los siguientes valores NTSTATUS.

Código devuelto Descripción
STATUS_SUCCESS
 El identificador de proveedor del redirector de red se devolvió correctamente en la variable a la que apunta el parámetro pProviderId .
STATUS_INVALID_PARAMETER
 Uno de los parámetros es null.
STATUS_OBJECT_NAME_NOT_FOUND
 El nombre del redirector de red especificado en el parámetro pProviderName no coincide con el nombre de ninguno de los proveedores UNC registrados con el MUP.

Observaciones

Un controlador de filtro del sistema de archivos puede llamar a la rutina FsRtlMupGetProviderIdFromName para obtener el identificador de proveedor de un redirector de red a partir del nombre del redirector de red. El controlador de filtro del sistema de archivos puede comparar rápidamente el valor de este identificador con el valor de otros identificadores de proveedor sin necesidad de realizar una comparación de cadenas.

El valor del identificador de proveedor para un redirector de red determinado sigue siendo el mismo si el redirector de red se descarga del sistema y, a continuación, se vuelve a cargar en el sistema.

Para obtener el identificador de proveedor de un redirector de red de un objeto de archivo, un controlador de filtro del sistema de archivos puede llamar a la rutina FsRtlMupGetProviderInfoFromFileObject.

Requisitos

Requisito Valor
cliente mínimo admitido La función FsRtlMupGetProviderIdFromName es Windows Vista
de la plataforma de destino de Universal
encabezado de ntifs.h (incluya Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL <= APC_LEVEL

Consulte también

FsRtlMupGetProviderInfoFromFileObject