Funzione FsRtlMupGetProviderIdFromName (ntifs.h)
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 contenente il nome del dispositivo del redirector di rete.
[out] pProviderId
Puntatore a una variabile tipizzata ULONG32 che riceve l'identificatore del provider del redirector di rete.
Valore restituito
La routine FsRtlMupGetProviderIdFromName restituisce uno dei valori NTSTATUS seguenti.
| Codice restituito | Descrizione |
|---|---|
|
L'identificatore del provider del redirector di rete è stato restituito correttamente nella variabile a cui punta il parametro pProviderId . |
|
Uno dei parametri è NULL. |
|
Il nome del redirector di rete specificato nel parametro pProviderName non corrisponde al nome di uno dei provider UNC registrati con MUP. |
Commenti
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 determinato 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 .
Requisiti
| 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 |