Função NPGetUser (npapi.h)

Artigo
03/05/2024

Recupera o valor do nome de usuário padrão atual ou do nome de usuário usado para estabelecer uma conexão de rede.

Sintaxe

DWORD NPGetUser(
  [in]      LPWSTR  lpName,
  [out]     LPWSTR  lpUserName,
  [in, out] LPDWORD lpnBufferLen
);

Parâmetros

[in] lpName

Ponteiro para o nome do dispositivo local no qual o chamador está interessado ou um nome remoto para um recurso ao qual o usuário fez uma conexão. Esse parâmetro poderá ser NULL ou a cadeia de caracteres vazia se o chamador estiver interessado no nome do usuário conectado ao sistema no momento. Se um nome remoto para um recurso for passado e o usuário estiver conectado a esse recurso usando nomes diferentes, é possível que um provedor não possa resolve qual nome de usuário retornar. Nesse caso, o provedor pode fazer uma escolha arbitrária entre os possíveis nomes de usuário.

[out] lpUserName

Ponteiro para um buffer para receber o nome de usuário. Esse deve ser um nome que pode ser passado para a função NPAddConnection ou NPAddConnection3 para restabelecer a conexão com o mesmo nome de usuário.

[in, out] lpnBufferLen

Ponteiro para o tamanho, em caracteres, do buffer lpUserName . Se a chamada falhar porque o buffer não é grande o suficiente, esse local será usado para retornar o tamanho do buffer necessário.

Retornar valor

Se a função for bem-sucedida, ela deverá retornar WN_SUCCESS. Caso contrário, ele deverá retornar um código de erro, que pode ser um dos seguintes.

Código de retorno	Descrição
WN_NOT_CONNECTED	O valor no parâmetro lpName não é o nome de um dispositivo redirecionado ou de um nome remoto conectado.
WN_MORE_DATA	O buffer, lpUserName, é muito pequeno.
WN_NO_NETWORK	A rede não está presente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	npapi.h