Compartilhar via


Função OpenNtmsNotification (ntmsapi.h)

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

A função OpenNtmsNotification abre um canal para receber notificações de alteração de objeto RSM para objetos do tipo especificado.

Sintaxe

HANDLE OpenNtmsNotification(
  [in] HANDLE hSession,
  [in] DWORD  dwType
);

Parâmetros

[in] hSession

Identificador para a sessão retornada pela função OpenNtmsSession .

[in] dwType

Tipo de objeto RSM para notificação. Para obter uma lista de valores, consulte NtmsObjectsTypes.

Retornar valor

A função OpenNtmsNotification retorna um identificador de notificação que você passa para as funções WaitForNtmsNotification ou CloseNtmsNotification .

Para obter informações de erro estendidas, chame a função GetLastError . Essa função pode retornar um dos valores a seguir.

Valor Significado
ERROR_ACCESS_DENIED
NTMS_USE_ACCESS para o computador é negado. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança.

Windows XP: Nenhum direito de acesso é necessário.

ERROR_DATABASE_FAILURE
Falha na consulta ou atualização do banco de dados.
ERROR_INVALID_HANDLE
O valor especificado no parâmetro hSession é NULL ou não é válido.
ERROR_NOT_CONNECTED
Não é possível se conectar ao serviço RSM.
ERROR_SUCCESS
A função foi bem-sucedida.
INVALID_HANDLE_VALUE
A função falhou.

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

CloseNtmsNotification

Funções de notificação de banco de dados

WaitForNtmsNotification