Função BeginNtmsDeviceChangeDetection (ntmsapi.h)

  • Artigo

[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 BeginNtmsDeviceChangeDetection permite que o aplicativo inicie uma sessão de detecção de alteração de dispositivo.

Sintaxe

DWORD BeginNtmsDeviceChangeDetection(
  [in]  HANDLE   hSession,
  [out] LPHANDLE lpDetectHandle
);

Parâmetros

[in] hSession

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

[out] lpDetectHandle

Ponteiro para variável que recebe o identificador de detecção de alteração do dispositivo.

Retornar valor

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

Valor Significado
ERROR_INVALID_HANDLE
 O valor do parâmetro hSession não é um identificador de sessão válido.
ERROR_SUCCESS
 A solicitação do operador foi cancelada.

Comentários

Depois de chamar BeginNtmsDeviceChangeDetection, o aplicativo pode definir as bibliotecas autônomas para as quais a detecção de alteração de mídia é necessária usando a função SetNtmsDeviceChangeDetection . O Gerenciador de Armazenamento Removível continua a detectar alterações para os dispositivos especificados até que a sessão de detecção de alterações seja fechada usando a função EndNtmsDeviceChangeDetection .

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

Alterar funções de detecção

EndNtmsDeviceChangeDetection

SetNtmsDeviceChangeDetection