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

Artigo
08/27/2023

O método IWCNDevice::GetStringAttribute obtém um atributo armazenado em cache do dispositivo como uma cadeia de caracteres.

Sintaxe

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

Parâmetros

[in] AttributeType

Um valor WCN_ATTRIBUTE_TYPE que representa um valor de atributo específico (por exemplo, WCN_PASSWORD_TYPE). Se o atributo não for nativamente um tipo de dados de cadeia de caracteres (por exemplo, WCN_TYPE_VERSION for nativamente um inteiro e WNC_TYPE_SSID for nativamente um blob), essa função falhará com HRESULT_FROM_WIN32(ERROR_INVALID_DATATYPE).

[in] cchMaxString

O tamanho do buffer wszString, em caracteres.

[out] wszString

Um buffer alocado pelo usuário que, no retorno bem-sucedido, contém um valor de cadeia de caracteres terminada em NULL da extensão do fornecedor.

Valor retornado

...

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 wszString não é grande o suficiente para conter o valor de atributo retornado.
HRESULT_FROM_WIN32(ERROR_INVALID_DATATYPE)	Esse atributo não pode ser expresso como uma cadeia de caracteres. Por exemplo, se for um inteiro.

Requisitos


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

Compartilhar via