Compartilhar via

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

  • Artigo

O método IWCNDevice::GetAttribute obtém um atributo armazenado em cache do dispositivo.

Sintaxe

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

Parâmetros

[in] AttributeType

Um valor WCN_ATTRIBUTE_TYPE que representa um valor de atributo específico (por exemplo, WCN_PASSWORD_TYPE).

[in] dwMaxBufferSize

O tamanho alocado, em bytes, de pbBuffer.

[out] pbBuffer

Um buffer alocado pelo usuário que, no retorno bem-sucedido, contém o conteúdo do atributo.

[out] pdwBufferUsed

No retorno, contém o tamanho do atributo em bytes.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O atributo foi recuperado com êxito.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 O atributo especificado não está disponível.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
 O buffer especificado por pbBuffer não é grande o suficiente para conter o valor de atributo retornado.

Comentários

Para consultar apenas o tamanho de um atributo, um valor de 0 (zero) pode ser passado por meio de dwMaxBufferSize e pdwBufferUsed será preenchido adequadamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho wcndevice.h

Confira também

IWCNDevice

WCN_ATTRIBUTE_TYPE