Metodo IWCNDevice::GetAttribute (wcndevice.h)

Articolo
03/13/2024

Il metodo IWCNDevice::GetAttribute ottiene un attributo memorizzato nella cache dal dispositivo.

Sintassi

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

Parametri

[in] AttributeType

Valore WCN_ATTRIBUTE_TYPE che rappresenta un valore di attributo specifico, ad esempio WCN_PASSWORD_TYPE.

[in] dwMaxBufferSize

Dimensione allocata, in byte, di pbBuffer.

[out] pbBuffer

Buffer allocato dall'utente che, in caso di esito positivo, contiene il contenuto dell'attributo.

[out] pdwBufferUsed

In caso di restituzione, contiene le dimensioni dell'attributo in byte.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	L'attributo è stato recuperato correttamente.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	L'attributo specificato non è disponibile.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Il buffer specificato da pbBuffer non è sufficientemente grande da contenere il valore dell'attributo restituito.

Commenti

Per eseguire query solo sulle dimensioni di un attributo, è possibile passare un valore pari a 0 (zero) tramite dwMaxBufferSize e pdwBufferUsed .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	wcndevice.h

Vedi anche

IWCNDevice

WCN_ATTRIBUTE_TYPE

Condividi tramite