Funzione SubmitNtmsOperatorRequestW (ntmsapi.h)

Articolo
11/20/2024

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

La funzione SubmitNtmsOperatorRequest invia una richiesta di operatore RSM.

Sintassi

DWORD SubmitNtmsOperatorRequestW(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCWSTR     lpMessage,
  [in]  LPNTMS_GUID lpArg1Id,
  [in]  LPNTMS_GUID lpArg2Id,
  [out] LPNTMS_GUID lpRequestId
);

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] dwRequest

Tipo di richiesta dell'operatore. Questo parametro può essere uno dei valori seguenti.

Valore	Significato
NTMS_OPREQ_CLEANER	RSM invia una richiesta di operatore per inserire un pulitore quando viene accodata un'operazione pulita e non è disponibile alcun pulitore per l'unità. Il parametro lpArg1Id può essere una libreria o un identificatore di slot. Richiede NTMS_CONTROL_ACCESS alla libreria. Windows XP: Non sono necessari diritti di accesso.
NTMS_OPREQ_DEVICESERVICE	Un'applicazione o RSM invia una richiesta di operatore per il servizio unità quando si verificano problemi in un dispositivo o un'unità del modificatore. Il parametro lpArg1Id specifica il dispositivo che necessita del servizio. Questo parametro può essere un identificatore di unità iedoor, libreria, supporti fisici o unità. Richiede NTMS_CONTROL_ACCESS alla libreria. Windows XP: Non sono necessari diritti di accesso.
NTMS_OPREQ_MESSAGE	Solo messaggio dell'applicazione. Richiede NTMS_USE_ACCESS al computer. Windows XP: Non sono necessari diritti di accesso.
NTMS_OPREQ_MOVEMEDIA	Un'applicazione o RSM invia una richiesta di operatore per spostare supporti da una libreria a un'altra per un montaggio di supporti offline o per espellere supporti esistenti nella libreria offline. Il parametro lpArg1Id specifica la parte di supporto fisico da spostare e il parametro lpArg2Id specifica la libreria di destinazione. Richiede NTMS_CONTROL_ACCESS al pool di supporti. Windows XP: Non sono necessari diritti di accesso.
NTMS_OPREQ_NEWMEDIA	Un'applicazione o RSM invia una richiesta di operatore per nuovi supporti quando non è disponibile alcun supporto. Il parametro lpArg1Id specifica l'oggetto pool di supporti e il parametro lpArg2Id è l'identificatore di libreria facoltativo a cui aggiungere il nuovo supporto. Richiede NTMS_CONTROL_ACCESS al pool di supporti. Windows XP: Non sono necessari diritti di accesso.

[in] lpMessage

Stringa di messaggio facoltativa da inviare all'utente.

[in] lpArg1Id

Identificatore dell'oggetto per la richiesta dell'operatore. Fare riferimento alle descrizioni dei valori nel parametro dwRequest per una descrizione del tipo di oggetto da passare per questo parametro.

[in] lpArg2Id

Identificatore dell'oggetto per la richiesta dell'operatore. Fare riferimento alle descrizioni dei valori nel parametro dwRequest per informazioni dettagliate sul tipo di oggetto da passare per questo parametro.

[out] lpRequestId

Puntatore a un buffer che riceve l'identificatore della richiesta dell'operatore creata.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	L'accesso a uno o più oggetti RSM viene negato.
ERROR_DATABASE_FAILURE	La query o l'aggiornamento del database non è riuscito.
ERROR_INVALID_HANDLE	Il valore specificato nel parametro hSession è NULL o non è valido.
ERROR_INVALID_PARAMETER	Uno dei valori dei parametri non è valido.
ERROR_NOT_CONNECTED	Impossibile connettersi al servizio RSM.
ERROR_OBJECT_NOT_FOUND	Impossibile trovare l'oggetto di origine o di destinazione.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Osservazioni

La funzione SubmitNtmsOperatorRequest invia una richiesta di operatore e restituisce lo stato della richiesta (soddisfatta o annullata) o si verifica il timeout (se l'operatore non agisce sulla richiesta). Le richieste degli operatori vengono usate per richiedere supporti, per richiedere che il supporto specificato venga spostato da una libreria a un'altra o per richiedere il servizio dispositivo RSM.

Il valore NTMS_OPEREQ_MESSAGE (nel parametro dwRequest) è il tipo di richiesta più spesso usato dalle applicazioni. RSM non può usare NTMS_OPEREQ_MESSAGE. RSM usa gli altri tipi di richiesta in base alle esigenze.

Nota

L'intestazione ntmsapi.h definisce SubmitNtmsOperatorRequest 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]
piattaforma di destinazione	Finestre
intestazione	ntmsapi.h
libreria	Ntmsapi.lib
dll	Ntmsapi.dll