Función DeleteNtmsRequests (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 DeleteNtmsRequests elimina una solicitud o una lista de solicitudes de la base de datos RSM. Las solicitudes de biblioteca o operador que se encuentran en un estado completado, erróneo, rechazado o cancelado se quitan. Las solicitudes enviadas, las solicitudes en cola, las solicitudes en espera y las solicitudes en curso no se pueden eliminar.

Sintaxis

DWORD DeleteNtmsRequests(
  [in] HANDLE      hSession,
  [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] lpRequestId

Lista de identificadores de las solicitudes de biblioteca y operador que se van a eliminar.

[in] dwType

Tipo de solicitud. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
NTMS_LIBREQUEST
 Solicitud de biblioteca.
NTMS_OPREQUEST
 Solicitud de operador.

[in] dwCount

Número de solicitudes de la lista.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS al equipo se deniega. También se pueden producir otros errores de seguridad, pero indicarían un error del subsistema de seguridad.

Windows XP: NTMS_CONTROL_ACCESS al equipo se deniega. También se pueden producir otros errores de seguridad, pero indicarían un error del subsistema de seguridad.
ERROR_DATABASE_FAILURE
 La base de datos no es accesible o está dañada.
ERROR_DATABASE_FULL
 La base de datos está llena.
ERROR_INVALID_PARAMETER
 El identificador de tipo no es válido.
ERROR_INVALID_HANDLE
 Falta el identificador de sesión o no es válido.
ERROR_NOT_ENOUGH_MEMORY
 Error de asignación de memoria durante el procesamiento.
ERROR_SUCCESS
 La función se ejecutó correctamente.

Comentarios

No se devuelve un error si no se encuentra una solicitud o una lista de solicitudes.

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

Funciones de control de biblioteca