Función NetRemoteComputerSupports (lmremutl.h)

  • Artículo

La función NetRemoteComputerSupports consulta al redirector para recuperar las características opcionales que admite el sistema remoto. Las características incluyen unicode, llamada a procedimiento remoto (RPC) y compatibilidad con el protocolo de administración remota. La función establece una conexión de red si no existe.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetRemoteComputerSupports(
  [in]  LPCWSTR UncServerName,
  [in]  DWORD   OptionsWanted,
  [out] LPDWORD OptionsSupported
);

Parámetros

[in] UncServerName

Puntero a una cadena constante que especifica el nombre del servidor remoto que se va a consultar. Si este parámetro es NULL, se usa el equipo local.

[in] OptionsWanted

Especifica un valor que contiene un conjunto de marcas de bits que indican las características de interés. Este parámetro debe ser al menos uno de los valores siguientes.

Valor Significado
SUPPORTS_REMOTE_ADMIN_PROTOCOL
 Solicita compatibilidad con el protocolo de administración remota.
SUPPORTS_RPC
 Solicita compatibilidad con RPC.
SUPPORTS_SAM_PROTOCOL
 Solicita compatibilidad con el Administrador de cuentas de seguridad (SAM).
SUPPORTS_UNICODE
 Solicita compatibilidad estándar con Unicode.
SUPPORTS_LOCAL
 Solicita compatibilidad con los tres primeros valores enumerados en esta tabla. Si la aplicación que realiza la llamada define UNICODE, solicita las cuatro características enumeradas anteriormente.

[out] OptionsSupported

Puntero a un valor que recibe un conjunto de marcas de bits. Las marcas indican qué características especifica el parámetro OptionsWanted se implementan en el equipo especificado por el parámetro UncServerName . (Todos los demás bits se establecen en cero).

El valor de este parámetro solo es válido cuando la función NetRemoteComputerSupports devuelve NERR_Success.

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
ERROR_INVALID_PARAMETER
 El parámetro OptionsWanted o el parámetro OptionsSupported son NULL; se requieren ambos parámetros.
ERROR_NOT_ENOUGH_MEMORY
 Memoria insuficiente disponible.

Comentarios

No se requiere ninguna pertenencia especial a grupos para ejecutar correctamente la función NetRemoteComputerSupports .

Requisitos

Requisito Value
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 lmremutl.h (include Lm.h)
Library Netapi32.lib
Archivo DLL Netapi32.dll

Consulte también

NetServerGetInfo

Funciones de administración de red

Introducción a la administración de redes

Funciones de utilidad remota