Função MprAdminUserSetInfo (mprapi.h)

Artigo
08/24/2023

A função MprAdminUserSetInfo define informações ras para o usuário especificado.

Sintaxe

DWORD MprAdminUserSetInfo(
  [in] LPCWSTR      lpszServer,
  [in] LPCWSTR      lpszUser,
  [in] DWORD        dwLevel,
  [in] const 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 definir informações ras.

[in] dwLevel

Esse parâmetro pode ser zero ou um, correspondente ao tipo de estrutura apontado pelo parâmetro lpbBuffer .

Windows NT Server 4.0 com SP3 e posterior: Esse parâmetro deve ser zero.

[in] lpbBuffer

Ponteiro para uma estrutura de RAS_USER_0 ou RAS_USER_1 que especifica as novas informações ras para o usuário.

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 .

Valor retornado

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.
ERRO _INVALID_LEVEL	O valor de dwLevel é inválido.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.
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 é fornecida com o RRAS redistribuível exporta a função como RasAdminUserSetInfo em vez de MprAdminUserSetInfo. Portanto, ao usar o RRAS redistribuível, use LoadLibrary e GetProcAddress para acessar essa função.

Requisitos


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