ICDBurn ::GetRecorderDriveLetter, méthode (shobjidl.h)

Article
03/13/2024

Obtient la lettre de lecteur d’un lecteur de CD qui a été marqué comme étant activé en écriture.

Syntaxe

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

Paramètres

[out] pszDrive

Type : LPWSTR

Pointeur vers une chaîne contenant la lettre de lecteur, par exemple « F : ».

[in] cch

Type : UINT

Taille de la chaîne, en caractères, pointée par pszDrive. Cette valeur est normalement 4. Les valeurs supérieures à 4 sont autorisées, mais les caractères supplémentaires seront ignorés par cette méthode. Les valeurs inférieures à 4 génèrent une erreur E_INVALIDARG.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le lecteur dont la désignation de lettre est retournée par cette méthode est le lecteur sur lequel l’option Activer l’écriture cd sur ce lecteur est sélectionnée. Cette option se trouve dans la feuille des propriétés du lecteur. Cette option peut être sélectionnée sur un seul lecteur sur un système.

Si un lecteur DE CD enregistrable est présent mais que cette option a été désélectionnée, la méthode retourne un code d’erreur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl.h
DLL	Shell32.dll

Partager via