Funzione DeleteNtmsRequests (ntmsapi.h)

Articolo
03/05/2024

[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]

La funzione DeleteNtmsRequests elimina una richiesta o un elenco di richieste dal database RSM. Le richieste di libreria o operatore che si trovano in uno stato completato, non riuscito, rifiutato o annullato vengono rimosse. Le richieste inviate, le richieste in coda, le richieste in attesa e le richieste in corso non possono essere eliminate.

Sintassi

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

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpRequestId

Elenco degli identificatori della libreria e delle richieste dell'operatore da eliminare.

[in] dwType

Tipo di richiesta. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
NTMS_LIBREQUEST	Richiesta di libreria.
NTMS_OPREQUEST	Richiesta dell'operatore.

[in] dwCount

Numero di richieste nell'elenco.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS al computer viene negato. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza. Windows XP: NTMS_CONTROL_ACCESS al computer viene negato. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza.
ERROR_DATABASE_FAILURE	Il database è inaccessibile o danneggiato.
ERROR_DATABASE_FULL	Il database è completo.
ERROR_INVALID_PARAMETER	L'identificatore di tipo non è valido.
ERROR_INVALID_HANDLE	L'handle di sessione non è valido o non è valido.
ERROR_NOT_ENOUGH_MEMORY	Errore di allocazione della memoria durante l'elaborazione.
ERROR_SUCCESS	La funzione è stata eseguita correttamente.

Commenti

Non viene restituito un errore se non viene trovata una richiesta o un elenco di richieste.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntmsapi.h
Libreria	Ntmsapi.lib
DLL	Ntmsapi.dll

Vedi anche

Funzioni di controllo della libreria

Condividi tramite