NetRemoteComputerSupports-Funktion (lmremutl.h)

  • Artikel

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