Funzione CancelNtmsLibraryRequest (ntmsapi.h)

Articolo
03/05/2024

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

La funzione CancelNtmsLibraryRequest annulla le richieste RSM in sospeso, ad esempio le chiamate alla funzione CleanNtmsDrive . Se la libreria è occupato, RSM accoda l'annullamento e restituisce l'esito positivo.

Sintassi

DWORD CancelNtmsLibraryRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId
);

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpRequestId

Identificatore univoco della richiesta di libreria da annullare.

Per recuperare l'elenco delle richieste di libreria esistenti, usare la funzione EnumerateNtmsObject .

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	Solo un amministratore del server RSM può annullare le richieste di libreria. Questo errore viene restituito anche se la richiesta è attualmente gestita e non può essere eliminata.
ERROR_INVALID_HANDLE	L'handle di sessione non è valido o non è valido.
ERROR_NOT_ENOUGH_MEMORY	Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_OBJECT_NOT_FOUND	L'ID oggetto della richiesta di libreria non è stato trovato. Questo errore si verifica se la richiesta viene completata prima di emettere l'annullamento o quando viene specificato un ID richiesta non valido.
ERROR_SUCCESS	La richiesta di libreria è stata accodata per l'annullamento.

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

EnumerateNtmsObject

Funzioni di controllo della libreria

Condividi tramite