Funzione NetRemoteComputerSupports (lmremutl.h)

Articolo
03/14/2023

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

Condividi tramite