Função OpenNtmsSessionW (ntmsapi.h)

Artigo
11/20/2024

[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

Reservado; deve ser zero.

Valor de retorno

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.

Observações

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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	ntmsapi.h
biblioteca	Ntmsapi.lib
de DLL	Ntmsapi.dll

Consulte também

CloseNtmsSession

Funções de gerenciamento de sessão

Compartilhar via