Funzione FsRtlMupGetProviderIdFromName (ntifs.h)

Articolo
12/21/2024

La routine FsRtlMupGetProviderIdFromName ottiene l'identificatore del provider di un redirector di rete registrato con più provider UNC (MUP) dal nome del dispositivo del redirector di rete.

Sintassi

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

Parametri

[in] pProviderName

Puntatore a una stringa Unicode che contiene il nome del dispositivo del redirector di rete.

[out] pProviderId

Puntatore a una variabile ULONG32 tipizzata che riceve l'identificatore del provider del reindirizzamento di rete.

Valore restituito

La routine FsRtlMupGetProviderIdFromName restituisce uno dei valori NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	L'identificatore del provider del reindirizzamento di rete è stato restituito correttamente nella variabile a cui punta il parametro pProviderId .
STATUS_INVALID_PARAMETER	Uno dei parametri è NULL.
STATUS_OBJECT_NAME_NOT_FOUND	Il nome del redirector di rete specificato nel parametro pProviderName non corrisponde al nome di uno dei provider UNC registrati con MUP.

Osservazioni

Un driver di filtro del file system può chiamare la routine FsRtlMupGetProviderIdFromName per ottenere l'identificatore del provider di un redirector di rete dal nome del redirector di rete. Il driver di filtro del file system può confrontare rapidamente il valore di questo identificatore con il valore di altri identificatori del provider senza dover eseguire un confronto tra stringhe.

Il valore dell'identificatore del provider per un particolare redirector di rete rimane invariato se il redirector di rete viene scaricato dal sistema e quindi ricaricato nel sistema.

Per ottenere l'identificatore del provider di un redirector di rete da un oggetto file, un driver di filtro del file system può chiamare la routine FsRtlMupGetProviderInfoFromFileObject.

Fabbisogno

Requisito	Valore
client minimo supportato	La funzione FsRtlMupGetProviderIdFromName è Windows Vista
piattaforma di destinazione	Universale
intestazione	ntifs.h (include Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	<= APC_LEVEL

Vedere anche

FsRtlMupGetProviderInfoFromFileObject

Condividi tramite