NetRemoteComputerSupports-Funktion (lmremutl.h)

Artikel
02/28/2024

Die NetRemoteComputerSupports-Funktion fragt den Redirector ab, um die optionalen Features abzurufen, die das Remotesystem unterstützt. Zu den Features gehören Unicode, Remote procedure Call (RPC) und Remoteverwaltungsprotokollunterstützung. Die Funktion stellt eine Netzwerkverbindung her, wenn keine vorhanden ist.

Syntax

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

Parameter

[in] UncServerName

Zeiger auf eine konstante Zeichenfolge, die den Namen des abzufragenden Remoteservers angibt. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] OptionsWanted

Gibt einen Wert an, der eine Reihe von Bitflags enthält, die die interessanten Features angibt. Dieser Parameter muss mindestens einer der folgenden Werte sein.

Wert	Bedeutung
SUPPORTS_REMOTE_ADMIN_PROTOCOL	Fordert Unterstützung des Remoteverwaltungsprotokolls an.
SUPPORTS_RPC	Fordert RPC-Unterstützung an.
SUPPORTS_SAM_PROTOCOL	Fordert Unterstützung des Sicherheitskonto-Managers (SAM) an.
SUPPORTS_UNICODE	Fordert Unicode-Standardunterstützung an.
SUPPORTS_LOCAL	Fordert Unterstützung für die ersten drei Werte an, die in dieser Tabelle aufgeführt sind. Wenn UNICODE von der aufrufenden Anwendung definiert wird, werden die vier zuvor aufgeführten Features angefordert.

[out] OptionsSupported

Zeiger auf einen Wert, der eine Reihe von Bitflags empfängt. Die Flags geben an, welche durch den OptionsWanted-Parameter angegebenen Features auf dem computer implementiert werden, der durch den UncServerName-Parameter angegeben wird. (Alle anderen Bits sind auf Null festgelegt.)

Der Wert dieses Parameters ist nur gültig, wenn die NetRemoteComputerSupports-Funktion NERR_Success zurückgibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Entweder der OptionsWanted-Parameter oder der OptionsSupported-Parameter ist NULL. Beide Parameter sind erforderlich.
ERROR_NOT_ENOUGH_MEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Es ist keine spezielle Gruppenmitgliedschaft erforderlich, um die NetRemoteComputerSupports-Funktion erfolgreich auszuführen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmremutl.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Weitere Informationen

NetServerGetInfo

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung

Remote-Hilfsprogrammfunktionen

Freigeben über