IWCNDevice::GetStringAttribute-Methode (wcndevice.h)

Artikel
08/27/2023

Die IWCNDevice::GetStringAttribute-Methode ruft ein zwischengespeichertes Attribut vom Gerät als Zeichenfolge ab.

Syntax

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

Parameter

[in] AttributeType

Ein WCN_ATTRIBUTE_TYPE Wert, der einen bestimmten Attributwert darstellt (z. B. WCN_PASSWORD_TYPE). Wenn das Attribut nicht systemintern ein Zeichenfolgendatentyp ist (z. B. WCN_TYPE_VERSION eine ganze Zahl ist und WNC_TYPE_SSID nativ ein Blob ist), schlägt diese Funktion mit HRESULT_FROM_WIN32(ERROR_INVALID_DATATYPE) fehl.

[in] cchMaxString

Die Größe des Puffers wszString in Zeichen.

[out] wszString

Ein vom Benutzer zugewiesener Puffer, der bei erfolgreicher Rückgabe einen NULL-endenden Zeichenfolgenwert der Anbietererweiterung enthält.

Rückgabewert

...

Rückgabecode	BESCHREIBUNG
S_OK	Das Attribut wurde erfolgreich abgerufen.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Das angegebene Attribut ist nicht verfügbar.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Der von wszString angegebene Puffer ist nicht groß genug, um den zurückgegebenen Attributwert zu enthalten.
HRESULT_FROM_WIN32(ERROR_INVALID_DATATYPE)	Dieses Attribut kann nicht als Zeichenfolge ausgedrückt werden. Beispielsweise, wenn es sich um eine ganze Zahl handelt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	wcndevice.h

Weitere Informationen

IWCNDevice

WCN_ATTRIBUTE_TYPE

Freigeben über