Função WaitForNtmsNotification (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 WaitForNtmsNotification aguarda a próxima notificação de alteração de objeto.

Sintaxe

DWORD WaitForNtmsNotification(
  [in]  HANDLE                         hNotification,
  [out] LPNTMS_NOTIFICATIONINFORMATION lpNotificationInformation,
  [in]  DWORD                          dwTimeout
);

Parâmetros

[in] hNotification

Identificador de notificação retornado pela função OpenNtmsNotification .

[out] lpNotificationInformation

Ponteiro para uma estrutura NTMS_NOTIFICATIONINFORMATION que recebe as informações de notificação.

[in] dwTimeout

Número máximo de milissegundos a aguardar. Se você especificar um valor de INFINITE, essa função não atingirá o tempo limite.

Retornar valor

Essa função retorna um dos valores a seguir.

Valor	Significado
ERROR_DATABASE_FAILURE	Falha na consulta ou atualização do banco de dados.
ERROR_INVALID_HANDLE	O valor especificado no parâmetro hNotification é NULL ou não é válido.
ERROR_NO_DATA	Falha no pipe de notificação. Tente configurar a notificação novamente.
ERROR_NOT_CONNECTED	Não é possível se conectar ao serviço RSM.
ERROR_TIMEOUT	O evento de tempo limite expirou.
ERROR_SUCCESS	A função foi executada com êxito.

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

NTMS_NOTIFICATIONINFORMATION

OpenNtmsNotification