Função CancelNtmsLibraryRequest (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 CancelNtmsLibraryRequest cancela solicitações RSM pendentes, como chamadas para a função CleanNtmsDrive . Se a biblioteca estiver ocupada, o RSM enfileira o cancelamento e retorna êxito.
Sintaxe
DWORD CancelNtmsLibraryRequest(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpRequestId
);
Parâmetros
[in] hSession
Manipule para a sessão retornada pela função OpenNtmsSession .
[in] lpRequestId
Identificador exclusivo da solicitação de biblioteca a ser cancelada.
Para recuperar a lista de solicitações de biblioteca existentes, use a função EnumerateNtmsObject .
Retornar valor
Essa função retorna um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Somente um administrador do servidor RSM pode cancelar solicitações de biblioteca. Esse erro também será retornado se a solicitação estiver sendo tratada no momento e não puder ser excluída. |
|
O identificador de sessão está ausente ou não é válido. |
|
Houve uma falha de alocação durante o processamento. |
|
A ID do objeto de solicitação de biblioteca não foi encontrada. Esse erro ocorrerá se a solicitação for concluída antes de emitir o cancelamento ou quando uma ID de solicitação que não é válida for especificada. |
|
A solicitação de biblioteca foi enfileirada para cancelamento. |
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 |