Función DeleteNtmsRequests (ntmsapi.h)

[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