IWCNDevice::GetAttribute-Methode (wcndevice.h)

Artikel
03/03/2024

Die IWCNDevice::GetAttribute-Methode ruft ein zwischengespeichertes Attribut vom Gerät ab.

Syntax

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

Parameter

[in] AttributeType

Ein WCN_ATTRIBUTE_TYPE Wert, der einen bestimmten Attributwert darstellt (z. B. WCN_PASSWORD_TYPE).

[in] dwMaxBufferSize

Die zugewiesene Größe von pbBuffer in Bytes.

[out] pbBuffer

Ein vom Benutzer zugewiesener Puffer, der bei erfolgreicher Rückgabe den Inhalt des Attributs enthält.

[out] pdwBufferUsed

Enthält bei rückgabe die Größe des Attributs in Bytes.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

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 pbBuffer angegebene Puffer ist nicht groß genug, um den zurückgegebenen Attributwert zu enthalten.

Hinweise

Um nur die Größe eines Attributs abzufragen, kann ein Wert von 0 (null) über dwMaxBufferSize übergeben werden, und pdwBufferUsed wird entsprechend ausgefüllt.

Anforderungen

Anforderung	Wert
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