FilterGetDosName 関数 (fltuser.h)

[アーティクル]
03/05/2024

FilterGetDosName 関数は、指定されたボリューム名に対応する MS-DOS デバイス名を返します。

構文

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

パラメーター

[in] lpVolumeName

ボリューム名を含む NULL で終わるワイド文字列へのポインター。

lpVolumeName 入力文字列には、次のいずれかを指定できます。末尾の円記号 (\) は省略可能です。

ドライブ文字 ("D:\" など)
"c:\mnt\edrive\" などのボリュームマウントポイントへのパス
"\?" などの一意 のボリューム識別子 (ボリューム GUID 名とも呼ばれます)。\Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
"\Device\HarddiskVolume1\" などの非永続デバイス 名 (ターゲット名 または NT デバイス名とも呼ばれます)

このパラメーターは必須であり、 NULL にすることはできません。

[out] lpDosName

MS-DOS デバイス名を NULL で終わるワイド文字列として受け取る呼び出し元によって割り当てられたバッファーへのポインター。

[in] dwDosNameBufferSize

lpDosName が指すバッファーのサイズ (ワイド文字)。

戻り値

FilterGetDosName は 、成功した場合S_OKを返します。それ以外の場合は、エラー値を返します。

注釈

FilterGetDosName は、ボリュームのドライブ文字がある場合は、そのドライブ文字を返します。ボリュームにドライブ文字が割り当てられていない場合、 FilterGetDosName はボリュームマウントポイント ( マウントポイント名とも呼ばれます) へのパスを返します。ボリュームにドライブ文字またはマウントポイントが定義されていない場合、 FilterGetDosName はS_OKを返し、 lpDosName は NULL を受け取ります。