Função NetRemoteComputerSupports (lmremutl.h)

  • Artigo

A função NetRemoteComputerSupports consulta o redirecionador para recuperar os recursos opcionais aos quais o sistema remoto dá suporte. Os recursos incluem Suporte a Unicode, RPC (Chamada de Procedimento Remoto) e Protocolo de Administração Remota. A função estabelecerá uma conexão de rede se uma não existir.

Sintaxe

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

Parâmetros

[in] UncServerName

Ponteiro para uma cadeia de caracteres constante que especifica o nome do servidor remoto a ser consultado. Se esse parâmetro for NULL, o computador local será usado.

[in] OptionsWanted

Especifica um valor que contém um conjunto de sinalizadores de bits que indica os recursos de interesse. Esse parâmetro deve ser pelo menos um dos valores a seguir.

Valor Significado
SUPPORTS_REMOTE_ADMIN_PROTOCOL
 Solicita suporte ao Protocolo de Administração Remota.
SUPPORTS_RPC
 Solicita suporte a RPC.
SUPPORTS_SAM_PROTOCOL
 Solicita suporte ao SAM (Gerenciador de Contas de Segurança).
SUPPORTS_UNICODE
 Solicita suporte padrão Unicode.
SUPPORTS_LOCAL
 Solicita suporte para os três primeiros valores listados nesta tabela. Se UNICODE for definido pelo aplicativo de chamada, solicitará os quatro recursos listados anteriormente.

[out] OptionsSupported

Ponteiro para um valor que recebe um conjunto de sinalizadores de bits. Os sinalizadores indicam quais recursos especificados pelo parâmetro OptionsWanted são implementados no computador especificado pelo parâmetro UncServerName . (Todos os outros bits são definidos como zero.)

O valor desse parâmetro é válido somente quando a função NetRemoteComputerSupports retorna NERR_Success.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NERR_Success.

Se a função falhar, o valor retornado poderá ser um dos códigos de erro a seguir.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 O parâmetro OptionsWanted ou o parâmetro OptionsSupported é NULL; ambos os parâmetros são necessários.
ERROR_NOT_ENOUGH_MEMORY
 Memória insuficiente disponível.

Comentários

Nenhuma associação de grupo especial é necessária para executar com êxito a função NetRemoteComputerSupports .

Requisitos

Requisito Valor
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 lmremutl.h (inclua Lm.h)
Biblioteca Netapi32.lib
DLL Netapi32.dll

Confira também

NetServerGetInfo

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede

Funções do Utilitário Remoto