Compartilhar via

Função DeleteNtmsRequests (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 DeleteNtmsRequests exclui uma solicitação ou uma lista de solicitações do banco de dados RSM. As solicitações de biblioteca ou operador que estão em um estado concluído, com falha, recusada ou cancelada são removidas. Solicitações enviadas, solicitações enfileiradas, solicitações de espera e solicitações em andamento não podem ser excluídas.

Sintaxe

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

Parâmetros

[in] hSession

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

[in] lpRequestId

Lista de identificadores das solicitações de biblioteca e operador a serem excluídas.

[in] dwType

Tipo de solicitação. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
NTMS_LIBREQUEST
 Solicitação de biblioteca.
NTMS_OPREQUEST
 Solicitação do operador.

[in] dwCount

Número de solicitações na lista.

Retornar valor

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

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS para o computador é negado. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança.

Windows XP: NTMS_CONTROL_ACCESS para o computador é negado. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança.
ERROR_DATABASE_FAILURE
 O banco de dados está inacessível ou danificado.
ERROR_DATABASE_FULL
 O banco de dados está cheio.
ERROR_INVALID_PARAMETER
 O identificador de tipo não é válido.
ERROR_INVALID_HANDLE
 O identificador de sessão está ausente ou não é válido.
ERROR_NOT_ENOUGH_MEMORY
 Falha de alocação de memória durante o processamento.
ERROR_SUCCESS
 A função foi executada com êxito.

Comentários

Um erro não será retornado se uma solicitação ou lista de solicitações não for encontrada.

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

Funções de controle de biblioteca