Método ICDBurn::GetRecorderDriveLetter (shobjidl.h)

Obtiene la letra de unidad de una unidad de CD que se ha marcado como habilitada para escritura.

Sintaxis

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

Parámetros

[out] pszDrive

Tipo: LPWSTR

Puntero a una cadena que contiene la letra de unidad, por ejemplo, "F:".

[in] cch

Tipo: UINT

Tamaño de la cadena, en caracteres, al que apunta pszDrive. Normalmente, este valor será 4. Se permiten valores mayores que 4, pero este método omitirá los caracteres adicionales. Los valores inferiores a 4 generarán un error de E_INVALIDARG.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La unidad cuya designación de letra se devuelve mediante este método es la unidad que tiene seleccionada la opción Habilitar escritura en cd en esta unidad . Esta opción se encuentra en la hoja de propiedades de la unidad. Solo una unidad de un sistema puede tener seleccionada esta opción.

Si hay una unidad de CD grabable, pero esa opción se ha deseleccionado, el método devolverá un código de error.

Requisitos