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 |
---|---|
|
O formato de nome do computador especificado não estava em um formato válido. |
|
Um dos valores de parâmetro não era válido. |
|
A rede não está iniciada ou não está disponível. |
|
Não é possível se conectar ao serviço RSM. |
|
O serviço RSM não foi iniciado. O aplicativo deve aguardar e tentar novamente. |
|
A função foi bem-sucedida. |
|
O RSM não pode abrir uma sessão. |
|
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 |