Funzione NetRemoteComputerSupports (lmremutl.h)

  • Articolo

La funzione NetRemoteComputerSupports esegue una query sul redirector per recuperare le funzionalità facoltative supportate dal sistema remoto. Le funzionalità includono il supporto unicode, RPC (Remote Procedure Call) e Remote Administration Protocol. Se non esiste, la funzione stabilisce una connessione di rete.

Sintassi

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

Parametri

[in] UncServerName

Puntatore a una stringa costante che specifica il nome del server remoto su cui eseguire una query. Se questo parametro è NULL, viene utilizzato il computer locale.

[in] OptionsWanted

Specifica un valore che contiene un set di flag di bit che indica le funzionalità di interesse. Questo parametro deve essere almeno uno dei valori seguenti.

Valore Significato
SUPPORTS_REMOTE_ADMIN_PROTOCOL
 Richiede il supporto del protocollo di amministrazione remota.
SUPPORTS_RPC
 Richiede il supporto RPC.
SUPPORTS_SAM_PROTOCOL
 Richiede il supporto di Security Account Manager (SAM).
SUPPORTS_UNICODE
 Richiede il supporto standard Unicode.
SUPPORTS_LOCAL
 Richiede il supporto per i primi tre valori elencati in questa tabella. Se UNICODE è definito dall'applicazione chiamante, richiede le quattro funzionalità elencate in precedenza.

[out] OptionsSupported

Puntatore a un valore che riceve un set di flag di bit. I flag indicano quali funzionalità specificate dal parametro OptionsWanted vengono implementate nel computer specificato dal parametro UncServerName . Tutti gli altri bit sono impostati su zero.

Il valore di questo parametro è valido solo quando la funzione NetRemoteComputerSupports restituisce NERR_Success.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NERR_Success.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.

Codice restituito Descrizione
ERROR_INVALID_PARAMETER
 Il parametro OptionsWanted o il parametro OptionsSupported è NULL; entrambi i parametri sono obbligatori.
ERROR_NOT_ENOUGH_MEMORY
 Memoria insufficiente disponibile.

Commenti

Per eseguire correttamente la funzione NetRemoteComputerSupports non è necessaria alcuna appartenenza a gruppi speciali.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione lmremutl.h (include Lm.h)
Libreria Netapi32.lib
DLL Netapi32.dll

Vedi anche

NetServerGetInfo

Funzioni di gestione di rete

Panoramica della gestione della rete

Funzioni di utilità remota