Función NetServerTransportAddEx (lmserver.h)
La función NetServerTransportAddEx enlaza el servidor especificado al protocolo de transporte. Esta función extendida permite a la aplicación que llama especificar los niveles de información de SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 .
Sintaxis
NET_API_STATUS NET_API_FUNCTION NetServerTransportAddEx(
[in] LMSTR servername,
[in] DWORD level,
[in] LPBYTE bufptr
);
Parámetros
[in] servername
Puntero a una cadena que especifica el nombre del servidor remoto en el que se va a ejecutar la función. Si este parámetro es NULL, se usa el equipo local.
[in] level
Especifica un valor que indica el nivel de información de los datos. Este parámetro puede ser uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
Especifica información sobre el protocolo de transporte, incluido el nombre, la dirección y la ubicación de la red. El parámetro bufptr apunta a una estructura SERVER_TRANSPORT_INFO_0 . |
|
Especifica información sobre el protocolo de transporte, incluido el nombre, la dirección, la ubicación de red y el dominio. El parámetro bufptr apunta a una estructura de SERVER_TRANSPORT_INFO_1 . |
|
Especifica la misma información que el nivel 1, con la adición de un miembro de svti2_flags . El parámetro bufptr apunta a una estructura SERVER_TRANSPORT_INFO_2 . |
|
Especifica la misma información que el nivel 2, con la adición de información de credenciales. El parámetro bufptr apunta a una estructura SERVER_TRANSPORT_INFO_3 . |
[in] bufptr
Puntero al búfer que contiene los datos. El formato de estos datos depende del valor del parámetro level .
Para obtener más información, consulte Búferes de funciones de administración de redes.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto se NERR_Success.
Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.
| Código devuelto | Descripción |
|---|---|
|
El usuario no tiene acceso a la información pedida. |
|
Existe un nombre duplicado en la red. |
|
No se encontró el nombre de dominio en la red. |
|
El valor especificado para el parámetro level no es válido. |
|
Si se devuelve este valor, significará que el parámetro en cuestión no es válido.
Este error se devuelve si el nombre de transporte o el miembro de dirección de transporte del SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 estructura a la que apunta el parámetro bufptr es NULL. Este error también se devuelve si el miembro de longitud de dirección de transporte del SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 o estructura de SERVER_TRANSPORT_INFO_3 apuntado por el parámetro bufptr es cero o mayor que MAX_PATH (definido en el archivo de encabezado Windef.h ). Este error también se devuelve si el miembro flags del SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 estructura a la que apunta el parámetro bufptr contiene un valor no válido. Este error también se devuelve para otros parámetros no válidos. |
|
Memoria insuficiente disponible. |
Comentarios
Solo los miembros del grupo local Administradores o Operadores de servidor pueden ejecutar correctamente la función NetServerTransportAddEx .
Si agrega un protocolo de transporte a un servidor mediante una llamada a la función NetServerTransportAddEx , la conexión no permanecerá después de que el servidor se reinicie o reinicie.
La función NetServerComputerNameAdd es una función de utilidad. Combina las características de la función NetServerTransportEnum y la función NetServerTransportAddEx , lo que le permite especificar un nombre de servidor emulado.
En Windows Server 2008 y Windows Vista con Service Pack 1 (SP1), cada nombre registrado con el servidor de archivos remoto de Windows (SRV) se designa como un nombre con ámbito o un nombre no con ámbito. Cada recurso compartido que se agrega al sistema se asociará a todos los nombres no con ámbito o a un nombre de ámbito único. Las aplicaciones que desean usar las características de ámbito son responsables de registrar el nuevo nombre como punto de conexión con ámbito y, a continuación, crear los recursos compartidos con un ámbito adecuado. De este modo, los usos heredados de las funciones administración de redes y administración de recursos compartidos de red no se ven afectados de ninguna manera, ya que siguen registrando recursos compartidos y nombres como nombres no con ámbito.
Se crea un punto de conexión con ámbito llamando a la función NetServerTransportAddExcon el parámetro level establecido en 2 y el parámetro bufptr apunta a una estructura de SERVER_TRANSPORT_INFO_2 con el valor de bits de SVTI2_SCOPED_NAME establecido en svti2_flags miembro. También se crea un punto de conexión con ámbito llamando a la función NetServerTransportAddExcon el parámetro level establecido en 3 y el parámetro bufptr apunta a una estructura de SERVER_TRANSPORT_INFO_3 con el valor de bits de SVTI2_SCOPED_NAME establecido en svti3_flags miembro.
Cuando se establece el valor de bit de SVTI2_SCOPED_NAME para un transporte, los recursos compartidos se pueden agregar con un nombre de servidor correspondiente (el miembro shi503_servername de la estructura SHARE_INFO_503 ) de forma con ámbito mediante la función NetShareAdd . Si no hay ningún transporte registrado con el valor de bit de SVTI2_SCOPED_NAME y el nombre proporcionado en shi503_servername miembro, el complemento compartido no se realizará correctamente.
La función NetShareAdd se usa para agregar un recurso compartido con ámbito en un servidor remoto especificado en el parámetro servername . El servidor remoto especificado en el miembro shi503_servername del SHARE_INFO_503 pasado en el parámetro bufptr debe haberse enlazado a un protocolo de transporte mediante la función NetServerTransportAddEx como punto de conexión con ámbito. La marca SVTI2_SCOPED_NAME debe haberse especificado en el miembro shi503_servername de la estructura SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 para el protocolo de transporte. La función NetShareDelEx se usa para eliminar un recurso compartido con ámbito. Las funciones NetShareGetInfo y NetShareSetInfo se usan para obtener y establecer información en un recurso compartido con ámbito.
Los puntos de conexión con ámbito suelen usarse en el espacio de nombres del clúster.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | lmserver.h (include Lm.h) |
| Library | Netapi32.lib |
| Archivo DLL | Netapi32.dll |
Consulte también
Funciones de administración de red