Función OpenNtmsNotification (ntmsapi.h)

[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]

La función OpenNtmsNotification abre un canal para recibir notificaciones de cambio de objetos RSM para objetos del tipo especificado.

Sintaxis

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

Parámetros

[in] hSession

Identificador de la sesión devuelta por la función OpenNtmsSession .

[in] dwType

Tipo de objeto RSM para la notificación. Para obtener una lista de valores, vea NtmsObjectsTypes.

Valor devuelto

La función OpenNtmsNotification devuelve un identificador de notificación que se pasa a las funciones WaitForNtmsNotification o CloseNtmsNotification .

Para obtener información de error extendida, llame a la función GetLastError . Esta función puede devolver uno de los siguientes valores.

Valor Significado
ERROR_ACCESS_DENIED
NTMS_USE_ACCESS al equipo se deniega. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad.

Windows XP: No se requieren derechos de acceso.

ERROR_DATABASE_FAILURE
Error en la consulta o actualización de la base de datos.
ERROR_INVALID_HANDLE
El valor especificado en el parámetro hSession es NULL o no es válido.
ERROR_NOT_CONNECTED
No se puede conectar al servicio RSM.
ERROR_SUCCESS
La función se realizó correctamente.
INVALID_HANDLE_VALUE
Error en la función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntmsapi.h
Library Ntmsapi.lib
Archivo DLL Ntmsapi.dll

Consulte también

CloseNtmsNotification

Funciones de notificación de base de datos

WaitForNtmsNotification