Funzione OpenNtmsSessionW (ntmsapi.h)

Articolo
11/20/2024

[ di Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]

La funzione OpenNtmsSession configura una sessione con un server RSM.

Sintassi

HANDLE OpenNtmsSessionW(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpApplication,
       DWORD   dwOptions
);

Parametri

[in] lpServer

Nome del server RSM. Se questo parametro è NULL, viene utilizzato il nome del computer corrente.

[in] lpApplication

Stringa di caratteri univoca che identifica l'applicazione. Questo nome identifica le risorse e le richieste dell'operatore. Questo parametro è facoltativo e può essere NULL.

dwOptions

Riservato; deve essere zero.

Valore restituito

Se OpenNtmsSession ha esito positivo, restituisce un handle che identifica in modo univoco questa sessione. Se la funzione ha esito negativo, restituisce INVALID_HANDLE_VALUE. Per recuperare altre informazioni, chiamare la funzione GetLastError . Questa funzione può restituire uno dei valori seguenti.

Valore	Significato
ERROR_INVALID_COMPUTERNAME	Il formato del nome del computer specificato non era in un formato valido.
ERROR_INVALID_PARAMETER	Uno dei valori dei parametri non è valido.
ERROR_NO_NETWORK	La rete non è stata avviata o non è disponibile.
ERROR_NOT_CONNECTED	Impossibile connettersi al servizio RSM.
ERROR_NOT_READY	Il servizio RSM non è stato avviato. L'applicazione deve attendere e riprovare.
ERROR_SUCCESS	La funzione ha avuto esito positivo.
INVALID_HANDLE_VALUE	RSM non può aprire una sessione.
RPC_S_NO_INTERFACES	Il servizio usa una versione precedente di RSM rispetto all'applicazione.

Osservazioni

La funzione OpenNtmsSession restituisce un handle di sessione usato con altre funzioni RSM, stabilisce una connessione con il database RSM e inizializza il sottosistema RSM per l'applicazione.

Quando restituisce OpenNtmsSession, l'applicazione può eseguire operazioni RSM.

Le sessioni sono thread-safe, ma non possono essere passate tra i processi.

Nota

L'intestazione ntmsapi.h definisce OpenNtmsSession come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	ntmsapi.h
libreria	Ntmsapi.lib
dll	Ntmsapi.dll

Vedere anche

CloseNtmsSession

funzioni di gestione delle sessioni

Condividi tramite