Funzione FilterGetDosName (fltuser.h)

Articolo
08/23/2023

La funzione FilterGetDosName restituisce il nome del dispositivo MS-DOS corrispondente al nome del volume specificato.

Sintassi

HRESULT FilterGetDosName(
  [in]  LPCWSTR lpVolumeName,
  [out] LPWSTR  lpDosName,
  [in]  DWORD   dwDosNameBufferSize
);

Parametri

[in] lpVolumeName

Puntatore a una stringa di caratteri wide con terminazione NULL contenente il nome del volume.

La stringa di input lpVolumeName può essere una delle seguenti. La barra rovesciata finale (\) è facoltativa.

Lettera di unità, ad esempio "D:\"
Percorso di un punto di montaggio del volume, ad esempio "c:\mnt\edrive\"
Identificatore di volume univoco (detto anche nome GUID del volume), ad esempio "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
Nome del dispositivo non permanente (detto anche nome di destinazione o nome di dispositivo NT), ad esempio "\Device\HarddiskVolume1\"

Questo parametro è obbligatorio e non può essere NULL.

[out] lpDosName

Puntatore a un buffer allocato dal chiamante che riceve il nome del dispositivo MS-DOS come stringa di caratteri wide con terminazione NULL.

[in] dwDosNameBufferSize

Dimensioni, in caratteri wide, del buffer a cui punta lpDosName .

Valore restituito

FilterGetDosName restituisce S_OK in caso di esito positivo. In caso contrario, restituisce un valore di errore.

Commenti

FilterGetDosName restituisce la lettera di unità del volume, se presente. Se al volume non viene assegnata alcuna lettera di unità, FilterGetDosName restituisce un percorso a un punto di montaggio del volume (detto anche nome di punto di montaggio). Se non vengono definite lettere di unità o punti di montaggio per il volume, FilterGetDosName restituisce S_OK e lpDosName riceve NULL.