Função SetNtmsDeviceChangeDetection (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 SetNtmsDeviceChangeDetection define um ou mais dispositivos de destino para detecção de alterações.

Sintaxe

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

Parâmetros

[in] hSession

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

[in] DetectHandle

Identificador de detecção de alteração de dispositivo de BeginNtmsDeviceChangeDetection ou NULL para uma única votação.

[in] lpRequestId

Identificador de objeto para o dispositivo de destino. Esse parâmetro pode ser uma ou mais GUIDs de biblioteca, tipo de mídia ou mídia física. Todos os GUIDs devem ser do mesmo tipo.

[in] dwType

Tipo de identificadores de objeto especificados no parâmetro lpObjectId . Esse parâmetro pode ser um dos seguintes valores do tipo de enumeração NtmsObjectsTypes : NTMS_LIBRARY, NTMS_MEDIA_TYPE ou NTMS_PHYSICAL_MEDIA.

[in] dwCount

Número de identificadores de objeto em lpObjectId.

Retornar valor

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

Valor	Significado
ERROR_INVALID_HANDLE	O identificador de sessão ou detecção não é válido.
ERROR_INVALID_PARAMETER	O tipo de objeto não é válido.
ERROR_INVALID_LIBRARY	A biblioteca especificada não foi encontrada.
ERROR_INVALID_MEDIA	A mídia ou tipo especificado não foi encontrado.
ERROR_SUCCESS	A solicitação do operador foi cancelada.

Comentários

O dispositivo pode ser especificado diretamente passando GUIDs de biblioteca ou indiretamente passando GUIDs de mídia física ou tipo de mídia. Ao usar a especificação indireta, todas as bibliotecas autônomas que podem conter o tipo de mídia ou mídia são detectadas. Todos os dispositivos especificados continuam a ser detectados até que o identificador de detecção de alteração do dispositivo seja fechado usando a função EndNtmsDeviceChangeDetection .

Essa função também pode ser usada para sondar a mídia alterada nos dispositivos especificados. Normalmente, isso é usado por uma interface do usuário ao abrir um nó folha ou implementar uma opção de atualização.

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

BeginNtmsDeviceChangeDetection

Funções de detecção de alterações

EndNtmsDeviceChangeDetection