Méthode IPrintDialogServices ::GetCurrentPortName (commdlg.h)

  • Article

Récupère le nom du port actuel à utiliser avec PrintDlgEx.

Syntaxe

HRESULT GetCurrentPortName(
  LPWSTR pPortName,
  UINT   *pcchSize
);

Paramètres

pPortName

Type : LPTSTR

Nom du port actuel.

pcchSize

Type : UINT*

Lors de l’entrée, la variable spécifie la taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre lpPortName . Lors de la sortie, la variable contient le nombre d’octets (ANSI) ou de caractères (Unicode), y compris le caractère null de fin, écrit dans la mémoire tampon.

Si la taille est égale à zéro à l’entrée, la fonction retourne la taille de mémoire tampon requise (en octets ou en caractères) dans pcchSize et n’utilise pas la mémoire tampon lpPortName .

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est S_OK. S’il n’y a pas de port actuel, la valeur de retour est S_OK, la valeur retournée dans pcchSize est zéro et la mémoire tampon lpPortName est inchangée.

Si une erreur se produit, la valeur renvoyée est un code d’erreur COM. Pour plus d’informations, consultez Gestion des erreurs.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête commdlg.h (inclure Windows.h)
DLL Comdlg32.dll

Voir aussi

Bibliothèque de boîtes de dialogue commune

Conceptuel

IPrintDialogServices

PrintDlgEx

Référence