IWiaErrorHandler :: GetStatusDescription, méthode

Retourne une chaîne qui décrit le code d’État.

Syntaxe

HRESULT GetStatusDescription(
  [in]  IUnknown *punkItem,
  [in]  HRESULT  hrStatus,
  [in]  LONG     cbResLength,
  [in]  BYTE     *pbData,
  [out] BSTR     *pbstrDescription
);

Paramètres

punkItem [ dans]

Type : IUnknown*

Pointeur vers le IUnknown de l’élément en cours de transfert. Cet objet implémente au minimum IWiaItem2 et IWiaDataTransfer.

hrStatus [ dans]

Type : HRESULT

HRESULT qui correspond au code d’état reçu par BandedDataCallback.

cbResLength [ dans]

Type : long

Valeur de type long qui correspond à la taille des données référencées par pbData.

pbData [ dans]

Type : Byte *

Pointeur vers la mémoire tampon de données telle qu’elle a été reçue par BandedDataCallback.

pbstrDescription [ à]

Type : BSTR *

BSTR qui reçoit une description de l’État ou de l’erreur rencontrée pendant le transfert de données. Ce paramètre ne peut pas être null. L’appelant doit libérer la chaîne à l’aide de SysFreeString, et l’implémenteur doit allouer la chaîne à l’aide de SysAllocString.

Valeur retournée

Type : HRESULT

Retourne l’une des valeurs suivantes.

Code de retour Description
_OK
pbstrDescription contient un pointeur BSTR valide.
S _ false
hrStatus est inconnu et aucune description n’est disponible.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2008 [ applications de bureau uniquement]
En-tête
WIA. h
MIDL
WIA. idl
Bibliothèque
Wiaguid. lib