Função MprAdminUserGetInfo (mprapi.h)

Artigo
02/29/2024

A função MprAdminUserGetInfo recupera todas as informações ras para um usuário específico.

Sintaxe

DWORD MprAdminUserGetInfo(
  [in]  LPCWSTR lpszServer,
  [in]  LPCWSTR lpszUser,
  [in]  DWORD   dwLevel,
  [out] LPBYTE  lpbBuffer
);

Parâmetros

[in] lpszServer

Ponteiro para uma cadeia de caracteres Unicode que especifica o nome do servidor com o subsistema de contas de usuário master (UAS). Se o servidor de acesso remoto fizer parte de um domínio, o computador com o UAS será o controlador de domínio primário ou o controlador de domínio de backup. Se o servidor de acesso remoto não fizer parte de um domínio, o próprio servidor armazenará o UAS. Em ambos os casos, chame a função MprAdminGetPDCServer para obter o valor desse parâmetro.

Se o próprio servidor armazenar o UAS, esse parâmetro poderá ser NULL.

[in] lpszUser

Ponteiro para uma cadeia de caracteres Unicode que especifica o nome do usuário para o qual obter informações RAS.

[in] dwLevel

Esse parâmetro pode ser zero ou um.

Windows NT Server 4.0 com SP3 e posteriores: esse parâmetro deve ser zero.

[out] lpbBuffer

Ponteiro para uma estrutura RAS_USER_0 ou RAS_USER_1 . O chamador deve alocar (e liberar) a memória para essa estrutura. Após o retorno bem-sucedido, essa estrutura contém os dados RAS para o usuário especificado.

Windows NT Server 4.0 com SP3 e posterior: se o parâmetro dwLevel especificar zero, lpbBuffer deverá apontar para uma estrutura RAS_USER_0.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos valores a seguir.

Valor	Significado
ERROR_ACCESS_DENIED	O chamador não tem privilégios suficientes.
ERROR_INVALID_LEVEL	O valor de dwLevel é inválido.
ERROR_INVALID_PARAMETER	lpbBuffer é NULL
ERROR_NO_SUCH_USER	O usuário especificado por lpwsUserName não existe no servidor especificado por lpwsServerName.

Comentários

Essa função estará disponível no Windows NT 4.0 se o RRAS redistribuível estiver instalado. No entanto, a versão de Mprapi.dll que acompanha o RRAS redistribuível exporta a função como RasAdminUserGetInfo em vez de MprAdminUserGetInfo. Portanto, ao usar o RRAS redistribuível, use LoadLibrary e GetProcAddress para acessar essa função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mprapi.h
Biblioteca	Mprapi.lib
DLL	Mprapi.dll