FilterGetDosName-Funktion (fltuser.h)

Artikel
02/26/2024

Die FilterGetDosName-Funktion gibt den MS-DOS-Gerätenamen zurück, der dem angegebenen Volumenamen entspricht.

Syntax

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

Parameter

[in] lpVolumeName

Zeiger auf eine NULL-beendete Breitzeichenzeichenfolge, die den Volumenamen enthält.

Die LpVolumeName-Eingabezeichenfolge kann eine der folgenden Sein: Der nachfolgende umgekehrte Schrägstrich (\) ist optional.

Ein Laufwerkbuchstabe, z. B. "D:\"
Ein Pfad zu einem Volumeeinbindungspunkt, z. B. "c:\mnt\edrive\"
Ein eindeutiger Volumebezeichner (auch als Volume-GUID-Name bezeichnet), z. B. "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
Ein nichtpersistent-Gerätename (auch als Zielname oder NT-Gerätename bezeichnet), z. B. "\Device\HarddiskVolume1\"

Dieser Parameter ist erforderlich und darf nicht NULL sein.

[out] lpDosName

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der den MS-DOS-Gerätenamen als NULL-beendete breitzeichenige Zeichenfolge empfängt.

[in] dwDosNameBufferSize

Größe des Puffers, auf den lpDosName verweist, in breiten Zeichen.

Rückgabewert

FilterGetDosName gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein Fehlerwert zurückgegeben.

Hinweise

FilterGetDosName gibt den Laufwerkbuchstaben des Volumes zurück, sofern es über einen verfügt. Wenn dem Volume kein Laufwerkbuchstabe zugewiesen ist, gibt FilterGetDosName einen Pfad zu einem Volumeeinbindungspunkt (auch als Bereitstellungspunktname bezeichnet) zurück. Wenn keine Laufwerkbuchstaben oder Bereitstellungspunkte für das Volume definiert sind, gibt FilterGetDosName S_OK zurück, und lpDosName empfängt NULL.