Función NetSetPrimaryComputerName (lmjoin.h)
La función NetSetPrimaryComputerName establece el nombre de equipo principal del equipo especificado.
Sintaxis
NET_API_STATUS NET_API_FUNCTION NetSetPrimaryComputerName(
[in, optional] LPCWSTR Server,
[in] LPCWSTR PrimaryName,
[in, optional] LPCWSTR DomainAccount,
[in, optional] LPCWSTR DomainAccountPassword,
[in] ULONG Reserved
);
Parámetros
[in, optional] Server
Puntero a una cadena constante que especifica el nombre del equipo en el que se va a ejecutar esta función. Si este parámetro es NULL, se usa el equipo local.
[in] PrimaryName
Puntero a una cadena constante que especifica el nombre principal que se va a establecer. Este nombre debe tener la forma de un nombre DNS completo.
[in, optional] DomainAccount
Puntero a una cadena constante que especifica la cuenta de dominio que se va a usar para tener acceso al objeto de cuenta de equipo para el equipo especificado en el parámetro Server de Active Directory. Si este parámetro es NULL, se usan las credenciales del usuario que ejecuta esta rutina.
Este parámetro no se usa si el servidor para ejecutar esta función no está unido a un dominio.
[in, optional] DomainAccountPassword
Puntero a una cadena constante que especifica la contraseña que coincide con la cuenta de dominio pasada en el parámetro DomainAccount . Si este parámetro es NULL, se usan las credenciales del usuario que ejecuta esta rutina.
Este parámetro se omite si el parámetro DomainAccount es NULL. Este parámetro no se usa si el servidor para ejecutar esta función no está unido a un dominio.
[in] Reserved
Reservado para uso futuro. Este parámetro debe ser NULL.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NERR_Success.
Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error o uno de los códigos de error del sistema.
| Código devuelto | Descripción |
|---|---|
|
Acceso denegado. Este error se devuelve si el autor de la llamada no era miembro del grupo local Administradores en el equipo de destino. |
|
Un parámetro name es incorrecto. Este error se devuelve si el parámetro PrimaryName no contiene un nombre válido. |
|
Un parámetro es incorrecto. Este error se devuelve si el parámetro DomainAccount no contiene un dominio válido. Este error también se devuelve si el parámetro DomainAccount no es NULL y el parámetro DomainAccountPassword no es NULL , pero no contiene una cadena Unicode. |
|
No hay suficiente memoria disponible para procesar este comando. |
|
No se admite la solicitud. Este error se devuelve si el equipo de destino especificado en el parámetro Server en el que se ejecuta esta función se ejecuta en Windows 2000 y versiones anteriores. |
|
No se ha iniciado el servicio Workstation. |
|
Ya hay una llamada a procedimiento remoto en curso para este subproceso. |
|
No se admite la secuencia de protocolo de llamada a procedimiento remoto. |
Comentarios
La función NetSetPrimaryComputerName es compatible con Windows XP y versiones posteriores.
La función NetSetPrimaryComputerName se usa como parte de las operaciones de cambio de nombre del equipo. El nombre especificado se quitará de la lista de nombres alternativo configurada para el equipo de destino y se configurará como nombre principal. El nombre de la cuenta de equipo se cambiará para que coincida con el nombre principal. El nombre del equipo principal anterior se mueve a la lista de nombres de equipo alternativo configurada para el equipo.
La función NetSetPrimaryComputerName requiere que el autor de la llamada sea miembro del grupo local Administradores en el equipo de destino.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | lmjoin.h (include Lm.h) |
| Library | Netapi32.lib |
| Archivo DLL | Netapi32.dll |