Função MprAdminUserSetInfo (mprapi.h)
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 |
|---|---|
|
O chamador não tem privilégios suficientes. |
|
O valor de dwLevel é inválido. |
|
Recursos insuficientes para concluir a operação. |
|
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 |