Méthode IWCNDevice ::GetAttribute (wcndevice.h)

Article
03/03/2024

La méthode IWCNDevice ::GetAttribute obtient un attribut mis en cache à partir de l’appareil.

Syntaxe

HRESULT GetAttribute(
  [in]  WCN_ATTRIBUTE_TYPE AttributeType,
  [in]  DWORD              dwMaxBufferSize,
  [out] BYTE []            pbBuffer,
  [out] DWORD              *pdwBufferUsed
);

Paramètres

[in] AttributeType

Valeur WCN_ATTRIBUTE_TYPE qui représente une valeur d’attribut spécifique (par exemple , WCN_PASSWORD_TYPE).

[in] dwMaxBufferSize

Taille allouée, en octets, de pbBuffer.

[out] pbBuffer

Mémoire tampon allouée par l’utilisateur qui, en cas de retour réussi, contient le contenu de l’attribut.

[out] pdwBufferUsed

Au retour, contient la taille de l’attribut en octets.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	L’attribut a été récupéré avec succès.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	L’attribut spécifié n’est pas disponible.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	La mémoire tampon spécifiée par pbBuffer n’est pas assez grande pour contenir la valeur d’attribut retournée.

Remarques

Pour interroger uniquement la taille d’un attribut, une valeur de 0 (zéro) peut être passée via dwMaxBufferSize et pdwBufferUsed est rempli de manière appropriée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	wcndevice.h

Voir aussi

IWCNDevice

WCN_ATTRIBUTE_TYPE

Partager via