Funzione SubmitNtmsOperatorRequestA (ntmsapi.h)

Articolo
03/08/2023

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

La funzione SubmitNtmsOperatorRequest invia una richiesta dell'operatore RSM.

Sintassi

DWORD SubmitNtmsOperatorRequestA(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCSTR      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ò avere uno dei valori seguenti.

Valore	Significato
NTMS_OPREQ_CLEANER	RSM invia una richiesta di operatore per inserire un pulitore quando un'operazione pulita viene accodata e non è disponibile alcuna pulizia 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 richiede il servizio. Questo parametro può essere un identificatore di 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 i 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 supporti fisici 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 multimediale 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. Per una descrizione del tipo di oggetto da passare per questo parametro, vedere le descrizioni dei valori nel parametro dwRequest .

[in] lpArg2Id

Identificatore dell'oggetto per la richiesta dell'operatore. Per informazioni dettagliate sul tipo di oggetto da passare per questo parametro, vedere le descrizioni dei valori nel parametro dwRequest .

[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.

Commenti

La funzione SubmitNtmsOperatorRequest invia una richiesta dell'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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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