Funzione FsRtlMupGetProviderIdFromName (ntifs.h)

  • Articolo

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
STATUS_SUCCESS
 L'identificatore del provider del redirector 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.

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

Vedi anche

FsRtlMupGetProviderInfoFromFileObject