Função OpenNtmsSessionW (ntmsapi.h)

[O Gerenciador de Armazenamento Removível não está mais disponível a partir do Windows 7 e do Windows Server 2008 R2.]

A função OpenNtmsSession configura uma sessão com um servidor RSM.

Sintaxe

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

Parâmetros

[in] lpServer

Nome do servidor RSM. Se esse parâmetro for NULL, o nome do computador atual será usado.

[in] lpApplication

Cadeia de caracteres exclusiva que identifica o aplicativo. Esse nome identifica recursos e solicitações de operador. Esse parâmetro é opcional e pode ser NULL.

dwOptions

Reservados; deve ser zero.

Retornar valor

Se OpenNtmsSession for bem-sucedido, ele retornará um identificador que identifica exclusivamente essa sessão. Se a função falhar, ela retornará INVALID_HANDLE_VALUE. Para recuperar mais informações, chame a função GetLastError . Essa função pode retornar um dos valores a seguir.

Valor	Significado
ERROR_INVALID_COMPUTERNAME	O formato de nome do computador especificado não estava em um formato válido.
ERROR_INVALID_PARAMETER	Um dos valores de parâmetro não era válido.
ERROR_NO_NETWORK	A rede não está iniciada ou não está disponível.
ERROR_NOT_CONNECTED	Não é possível se conectar ao serviço RSM.
ERROR_NOT_READY	O serviço RSM não foi iniciado. O aplicativo deve aguardar e tentar novamente.
ERROR_SUCCESS	A função foi bem-sucedida.
INVALID_HANDLE_VALUE	O RSM não pode abrir uma sessão.
RPC_S_NO_INTERFACES	O serviço está usando uma versão mais antiga do RSM do que seu aplicativo.

Comentários

A função OpenNtmsSession retorna um identificador de sessão usado com outras funções RSM, estabelece uma conexão com o banco de dados RSM e inicializa o subsistema RSM para o aplicativo.

Quando OpenNtmsSession retorna, o aplicativo pode executar operações RSM.

As sessões são thread-safe, mas não podem ser passadas entre processos.

Observação

O cabeçalho ntmsapi.h define OpenNtmsSession como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ntmsapi.h
Biblioteca	Ntmsapi.lib
DLL	Ntmsapi.dll

Confira também

CloseNtmsSession

Funções de gerenciamento de sessão