struttura NTMS_LIBREQUESTINFORMATIONW (ntmsapi.h)

Articolo
11/20/2024

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

La struttura NTMS_LIBREQUESTINFORMATION definisce le proprietà specifiche di una richiesta di lavoro, accodate a RSM.

Sintassi

typedef struct _NTMS_LIBREQUESTINFORMATIONW {
  DWORD      OperationCode;
  DWORD      OperationOption;
  DWORD      State;
  NTMS_GUID  PartitionId;
  NTMS_GUID  DriveId;
  NTMS_GUID  PhysMediaId;
  NTMS_GUID  Library;
  NTMS_GUID  SlotId;
  SYSTEMTIME TimeQueued;
  SYSTEMTIME TimeCompleted;
  WCHAR      szApplication[NTMS_APPLICATIONNAME_LENGTH];
  WCHAR      szUser[NTMS_USERNAME_LENGTH];
  WCHAR      szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONW;

Membri

OperationCode

Operazione dell'elemento. Può trattarsi di uno dei valori seguenti.

Valore	Significato
NTMS_LM_CLASSIFY	Classificare il supporto.
NTMS_LM_CLEANDRIVE	Pulire un'unità.
NTMS_LM_DISABLELIBRARY	Disabilitare il modificatore.
NTMS_LM_DISABLEDRIVE	Disabilitare un'unità.
NTMS_LM_DISABLEMEDIA	Disabilitare il supporto.
NTMS_LM_DISMOUNT	Smontare il supporto da un'unità.
NTMS_LM_DOORACCESS	Consentire l'accesso ai supporti tramite una porta dell'unità di libreria.
NTMS_LM_EJECT	Espellere il supporto dalla libreria.
NTMS_LM_EJECTCLEANER	Espellere un pulitore.
NTMS_LM_ENABLELIBRARY	Abilitare il modificatore.
NTMS_LM_ENABLEDRIVE	Abilitare un'unità.
NTMS_LM_ENABLEMEDIA	Abilitare il supporto.
NTMS_LM_INJECT	Inserire il supporto nella libreria.
NTMS_LM_INJECTCLEANER	Inserire un pulitore.
NTMS_LM_INVENTORY	Eseguire un inventario della libreria.
NTMS_LM_MOUNT	Montare un lato su un'unità.
NTMS_LM_PROCESSOMID	Elaborare l'OMID.
NTMS_LM_RELEASECLEANER	Rilasciare uno slot più pulito.
NTMS_LM_REMOVE	Rimuovere un elemento di lavoro dalla coda.
NTMS_LM_RESERVECLEANER	Riservare uno slot più pulito.
NTMS_LM_UPDATEOMID	Aggiornare l'OMID.
NTMS_LM_WRITESCRATCH	Scrivere un'etichetta libera.

OperationOption

Opzioni dell'elemento di lavoro (specifico del comando).

State

Stato corrente di questo elemento di lavoro. Può trattarsi di uno dei valori seguenti.

Valore	Significato
NTMS_LM_QUEUED	L'operazione viene accodata.
NTMS_LM_INPROCESS	L'operazione viene elaborata.
NTMS_LM_PASSED	Operazione completata correttamente.
NTMS_LM_FAILED	Operazione completata con un errore.
NTMS_LM_WAITING	L'operazione è bloccata.
NTMS_LM_CANCELLED	Operazione annullata.
NTMS_LM_INVALID	Operazione non valida.

PartitionId

Identificatore univoco di un lato sottoposto a manutenzione.

DriveId

Identificatore univoco di un'unità di cui viene eseguito il servizio.

PhysMediaId

Identificatore univoco di un componente multimediale fisico sottoposto a manutenzione.

Library

Libreria per questa richiesta.

SlotId

Identificatore univoco di uno slot del componente multimediale fisico di cui viene eseguito il servizio.

TimeQueued

Ora di sistema in cui la richiesta è stata accodata a RSM.

TimeCompleted

Ora di sistema completata da RSM.

szApplication[NTMS_APPLICATIONNAME_LENGTH]

Applicazione che ha inviato la richiesta dell'operatore.

szUser[NTMS_USERNAME_LENGTH]

Utente interattivo connesso al computer che ha inviato la richiesta dell'operatore.

szComputer[NTMS_COMPUTERNAME_LENGTH]

Computer che ha inviato la richiesta dell'operatore.

dwErrorCode

Errore restituito per le richieste che restituiscono con stato NTMS_LM_FAILED. Si tratta di un codice di errore di sistema .

WorkItemId

ID elemento di lavoro associato per questa richiesta. Attualmente viene usato per contenere l'ID dell'elemento di lavoro da annullare in una richiesta di NTMS_LM_REMOVE.

dwPriority

Priorità dell'elemento di lavoro.

Osservazioni

La struttura NTMS_LIBREQUESTINFORMATION è inclusa nella struttura NTMS_OBJECTINFORMATION.

GUID nei tempi di lavoro potrebbe non essere valido nel tempo. Ad esempio, un'eject di un supporto libero elimina il PMID dopo l'espulso del supporto. Tuttavia, l'elemento di lavoro non viene aggiornato al completamento dell'eject.

Nota

L'intestazione ntmsapi.h definisce NTMS_LIBREQUESTINFORMATION come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	ntmsapi.h

Vedere anche

NTMS_OBJECTINFORMATION

Condividi tramite