Función SetNtmsDeviceChangeDetection (ntmsapi.h)

  • Artículo

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

La función SetNtmsDeviceChangeDetection establece uno o varios dispositivos de destino para la detección de cambios.

Sintaxis

DWORD SetNtmsDeviceChangeDetection(
  [in] HANDLE      hSession,
  [in] HANDLE      DetectHandle,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

Parámetros

[in] hSession

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

[in] DetectHandle

Identificador de detección de cambios de dispositivo de BeginNtmsDeviceChangeDetection o NULL para un solo sondeo.

[in] lpRequestId

Identificador de objeto del dispositivo de destino. Este parámetro puede ser uno o varios GUID de medios físicos o de biblioteca. Todos los GUID deben ser del mismo tipo.

[in] dwType

Tipo de identificadores de objeto especificados en el parámetro lpObjectId . Este parámetro puede ser uno de los siguientes valores del tipo de enumeración NtmsObjectsTypes : NTMS_LIBRARY, NTMS_MEDIA_TYPE o NTMS_PHYSICAL_MEDIA.

[in] dwCount

Número de identificadores de objeto en lpObjectId.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_INVALID_HANDLE
 La sesión o el identificador de detección no son válidos.
ERROR_INVALID_PARAMETER
 El tipo de objeto no es válido.
ERROR_INVALID_LIBRARY
 No se encontró la biblioteca especificada.
ERROR_INVALID_MEDIA
 No se encontró el medio o el tipo especificados.
ERROR_SUCCESS
 Se ha cancelado la solicitud del operador.

Comentarios

El dispositivo se puede especificar directamente pasando GUID de biblioteca o indirectamente pasando GUID de medios físicos o de tipo multimedia. Al usar la especificación indirecta, se detectan todas las bibliotecas independientes que podrían contener el tipo de medio o medio. Todos los dispositivos especificados continúan detectándose hasta que se cierre el identificador de detección de cambios del dispositivo mediante la función EndNtmsDeviceChangeDetection .

Esta función también se puede usar para sondear los medios modificados en los dispositivos especificados. Normalmente, se usa en una interfaz de usuario al abrir un nodo hoja o implementar una opción de actualizació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

BeginNtmsDeviceChangeDetection

Funciones de detección de cambios

EndNtmsDeviceChangeDetection