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

Obtém a letra da unidade de uma unidade de CD que foi marcada como habilitada para gravação.

Sintaxe

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

Parâmetros

[out] pszDrive

Tipo: LPWSTR

Um ponteiro para uma cadeia de caracteres que contém a letra da unidade, por exemplo, "F:".

[in] cch

Tipo: UINT

O tamanho da cadeia de caracteres, em caracteres, apontado por pszDrive. Esse valor normalmente será 4. Valores maiores que 4 são permitidos, mas os caracteres extras serão ignorados por esse método. Valores menores que 4 gerarão um erro de E_INVALIDARG.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A unidade cuja designação de letra é retornada por esse método é a unidade que tem a opção Habilitar gravação de cd nesta unidade selecionada. Essa opção é encontrada na folha de propriedades da unidade. Somente uma unidade em um sistema pode ter essa opção selecionada.

Se uma unidade de CD gravável estiver presente, mas essa opção tiver sido desmarcada, o método retornará um código de erro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl.h
DLL	Shell32.dll