Função NPGetUser (npapi.h)
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 |
---|---|
|
O valor no parâmetro lpName não é o nome de um dispositivo redirecionado ou de um nome remoto conectado. |
|
O buffer, lpUserName, é muito pequeno. |
|
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 |