Função FsRtlMupGetProviderIdFromName (ntifs.h)

Artigo
12/21/2024

A rotina FsRtlMupGetProviderIdFromName obtém o identificador do provedor de um redirecionador de rede registrado com o MUP (provedor UNC múltiplo) do nome do dispositivo do redirecionador de rede.

Sintaxe

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

Parâmetros

[in] pProviderName

Um ponteiro para uma cadeia de caracteres Unicode que contém o nome do dispositivo do redirecionador de rede.

[out] pProviderId

Um ponteiro para uma variável tipo ULONG32 que recebe o identificador do provedor do redirecionador de rede.

Valor de retorno

A rotina FsRtlMupGetProviderIdFromName retorna um dos seguintes valores NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	O identificador do provedor do redirecionador de rede foi retornado com êxito na variável que é apontada pelo parâmetro pProviderId .
STATUS_INVALID_PARAMETER	Um dos parâmetros é NULL.
STATUS_OBJECT_NAME_NOT_FOUND	O nome do redirecionador de rede especificado no parâmetro pProviderName não corresponde ao nome de nenhum dos provedores UNC registrados com o MUP.

Observações

Um driver de filtro do sistema de arquivos pode chamar o FsRtlMupGetProviderIdFromName rotina para obter o identificador de provedor de um redirecionador de rede do nome do redirecionador de rede. O driver de filtro do sistema de arquivos pode comparar rapidamente o valor desse identificador com o valor de outros identificadores de provedor sem a necessidade de fazer uma comparação de cadeia de caracteres.

O valor do identificador do provedor para um redirecionador de rede específico permanecerá o mesmo se o redirecionador de rede for descarregado do sistema e recarregado novamente no sistema.

Para obter o identificador do provedor de um redirecionador de rede de um objeto de arquivo, um driver de filtro do sistema de arquivos pode chamar o FsRtlMupGetProviderInfoFromFileObject rotina.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	A função FsRtlMupGetProviderIdFromName é Windows Vista
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte também

FsRtlMupGetProviderInfoFromFileObject

Compartilhar via