ICDBurn::GetRecorderDriveLetter メソッド (shobjidl.h)

  • [アーティクル]

書き込み可能としてマークされている CD ドライブのドライブ文字を取得します。

構文

HRESULT GetRecorderDriveLetter(
  [out] LPWSTR pszDrive,
  [in]  UINT   cch
);

パラメーター

[out] pszDrive

種類: LPWSTR

ドライブ文字を含む文字列へのポインター (例: "F:")。

[in] cch

型: UINT

pszDrive が指す文字列のサイズ (文字単位)。 通常、この値は 4 になります。 4 より大きい値は使用できますが、このメソッドでは余分な文字は無視されます。 4 未満の値を指定すると、E_INVALIDARG エラーが発生します。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

このメソッドによって文字の指定が返されるドライブは、[ このドライブでの cd 書き込みを有効にする] オプションが選択されているドライブです。 このオプションは、ドライブのプロパティ シートにあります。 このオプションを選択できるのは、システム上の 1 つのドライブのみです。

記録可能な CD ドライブが存在するが、そのオプションが選択解除されている場合、メソッドはエラー コードを返します。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shobjidl.h
[DLL] Shell32.dll