OpenNtmsSessionA-Funktion (ntmsapi.h)

Artikel
11/20/2024

[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]

Die OpenNtmsSession--Funktion richtet eine Sitzung mit einem RSM-Server ein.

Syntax

HANDLE OpenNtmsSessionA(
  [in] LPCSTR lpServer,
  [in] LPCSTR lpApplication,
       DWORD  dwOptions
);

Parameter

[in] lpServer

RSM-Servername. Wenn dieser Parameter NULL-ist, wird der aktuelle Computername verwendet.

[in] lpApplication

Eindeutige Zeichenfolge, die die Anwendung identifiziert. Dieser Name identifiziert Ressourcen- und Operatoranforderungen. Dieser Parameter ist optional und kann NULL-sein.

dwOptions

Reserviert; muss null sein.

Rückgabewert

Wenn OpenNtmsSession erfolgreich ist, wird ein Handle zurückgegeben, das diese Sitzung eindeutig identifiziert. Wenn die Funktion fehlschlägt, wird INVALID_HANDLE_VALUE zurückgegeben. Rufen Sie zum Abrufen weiterer Informationen die GetLastError--Funktion auf. Diese Funktion kann einen der folgenden Werte zurückgeben.

Wert	Bedeutung
ERROR_INVALID_COMPUTERNAME	Das angegebene Computernamenformat war nicht in einem gültigen Format enthalten.
ERROR_INVALID_PARAMETER	Einer der Parameterwerte war ungültig.
ERROR_NO_NETWORK	Das Netzwerk ist nicht gestartet oder nicht verfügbar.
ERROR_NOT_CONNECTED	Es kann keine Verbindung mit dem RSM-Dienst hergestellt werden.
ERROR_NOT_READY	DER RSM-Dienst wurde nicht gestartet. Die Anwendung sollte warten und wiederholen.
ERROR_SUCCESS	Die Funktion war erfolgreich.
INVALID_HANDLE_VALUE	RSM kann keine Sitzung öffnen.
RPC_S_NO_INTERFACES	Der Dienst verwendet eine ältere Version von RSM als Ihre Anwendung.

Bemerkungen

Die OpenNtmsSession--Funktion gibt ein Sitzungshandle zurück, das mit anderen RSM-Funktionen verwendet wird, stellt eine Verbindung mit der RSM-Datenbank her und initialisiert das RSM-Subsystem für die Anwendung.

Wenn OpenNtmsSession- zurückgegeben wird, kann die Anwendung RSM-Vorgänge ausführen.

Sitzungen sind threadsicher, können aber nicht zwischen Prozessen übergeben werden.

Anmerkung

Der ntmsapi.h-Header definiert OpenNtmsSession als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	ntmsapi.h
Library	Ntmsapi.lib
DLL-	Ntmsapi.dll

Siehe auch

CloseNtmsSession-

Sitzungsverwaltungsfunktionen

Freigeben über