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 (MUP) múltiple del nombre del 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 con 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.

Comentarios

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 del proveedor para un redirector de red determinado sigue siendo el mismo si el redirector de red se descarga desde el 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 Value
Cliente mínimo compatible La función FsRtlMupGetProviderIdFromName es Windows Vista
Plataforma de destino Universal
Encabezado ntifs.h (incluya Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Consulte también

FsRtlMupGetProviderInfoFromFileObject