IWCNDevice::GetStringAttribute, méthode (wcndevice.h)

Article
08/27/2023

La méthode IWCNDevice::GetStringAttribute obtient un attribut mis en cache de l’appareil sous forme de chaîne.

Syntaxe

HRESULT GetStringAttribute(
  [in]  WCN_ATTRIBUTE_TYPE AttributeType,
  [in]  DWORD              cchMaxString,
  [out] WCHAR []           wszString
);

Paramètres

[in] AttributeType

Valeur WCN_ATTRIBUTE_TYPE qui représente une valeur d’attribut spécifique (par exemple, WCN_PASSWORD_TYPE). Si l’attribut n’est pas un type de données de chaîne en mode natif (par exemple, WCN_TYPE_VERSION est un entier en mode natif et WNC_TYPE_SSID est un objet blob), cette fonction échoue avec HRESULT_FROM_WIN32(ERROR_INVALID_DATATYPE) .

[in] cchMaxString

Taille de la mémoire tampon wszString, en caractères.

[out] wszString

Mémoire tampon allouée par l’utilisateur qui, en cas de retour réussi, contient une valeur de chaîne terminée null de l’extension du fournisseur.

Valeur retournée

...

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 wszString n’est pas assez grande pour contenir la valeur d’attribut retournée.
HRESULT_FROM_WIN32(ERROR_INVALID_DATATYPE)	Cet attribut ne peut pas être exprimé sous forme de chaîne. Par exemple, s’il s’agit d’un entier.

Configuration requise


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