Funzione OpenNtmsSessionA (ntmsapi.h)
[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 OpenNtmsSessionA(
[in] LPCSTR lpServer,
[in] LPCSTR lpApplication,
DWORD dwOptions
);
Parametri
[in] lpServer
Nome del server RSM. Se questo parametro è NULL, viene usato 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
Riservati; 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 |
|---|---|
|
Il formato del nome computer specificato non era in un formato valido. |
|
Uno dei valori dei parametri non è valido. |
|
La rete non è avviata o non è disponibile. |
|
Impossibile connettersi al servizio RSM. |
|
Il servizio RSM non è stato avviato. L'applicazione deve attendere e riprovare. |
|
La funzione ha avuto esito positivo. |
|
RSM non può aprire una sessione. |
|
Il servizio usa una versione precedente di RSM rispetto all'applicazione. |
Commenti
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 OpenNtmsSession restituisce, l'applicazione può eseguire operazioni RSM.
Le sessioni sono thread-safe, ma non possono essere passate tra 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 di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ntmsapi.h |
| Libreria | Ntmsapi.lib |
| DLL | Ntmsapi.dll |