Funzione SetNtmsUIOptionsA (ntmsapi.h)

  • Articolo

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

La funzione SetNtmsUIOptions modifica l'elenco dei nomi di computer in cui viene indirizzato il tipo specificato di interfaccia utente per l'oggetto specificato.

Sintassi

DWORD SetNtmsUIOptionsA(
  [in]  HANDLE            hSession,
  [in]  const LPNTMS_GUID lpObjectId,
  [in]  DWORD             dwType,
  [in]  DWORD             dwOperation,
  [out] LPCSTR            lpszDestination
);

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpObjectId

Identificatore univoco dell'oggetto di cui viene reindirizzata l'interfaccia utente. L'oggetto deve essere un contenitore che può essere un'origine per gli eventi. L'oggetto può essere un'applicazione (una richiesta di montaggio attivata dall'applicazione), una libreria (una richiesta aperta di porta in risposta a un'esezione) o un computer (tutte le interfacce utente relative al computer).

Per specificare il contenitore computer impostare il puntatore lpObjectId per puntare a un buffer con il GUID dell'oggetto computer di Gestione archiviazione rimovibile. Per specificare un determinato set di librerie per puntare a un buffer con il GUID della libreria. Per specificare un'applicazione, passare un puntatore NULL . L'identità dell'applicazione è determinata dalla sessione usata in hSession. Si noti che un'applicazione può avere più sessioni aperte contemporaneamente. In questo caso, il set di valori si applica solo alla sessione hSession . Nel caso di una libreria o di un'istanza del computer, le impostazioni vengono mantenute fino a quando non vengono modificate in modo esplicito. Le righe dell'applicazione vengono eliminate quando la sessione viene chiusa.

[in] dwType

Questo parametro può avere uno dei valori seguenti.

Valore Significato
NTMS_UITYPE_INFO
 Messaggi dell'interfaccia utente che forniscono informazioni. Questi includono gli elementi della coda di lavoro che indicano lo stato di avanzamento. Ad esempio, montare le richieste.
NTMS_UITYPE_REQ
 Messaggi dell'interfaccia utente che sono richieste. Queste includono le richieste dell'operatore che gestiscono i supporti. Ad esempio, una richiesta di inserimento di nuovi supporti.
NTMS_UITYPE_ERR
 Messaggi dell'interfaccia utente che forniscono informazioni sugli errori. Queste includono le richieste dell'operatore correlate alla notifica degli errori. Ad esempio, una richiesta di pulizia dell'unità.

[in] dwOperation

Questo parametro può avere uno dei valori seguenti.

Valore Significato
NTMS_UIDEST_ADD
 Aggiungere una nuova destinazione (nome computer) all'elenco.
NTMS_UIDEST_DELETE
 Rimuovere una destinazione dall'elenco.
NTMS_UIDEST_DELETEALL
 Cancellare tutte le destinazioni dall'elenco. Nessuna interfaccia utente per l'oggetto viene generata. In questo caso, l'argomento di destinazione viene ignorato.

[out] lpszDestination

Stringa multipla che restituisce i nomi dei computer a cui viene reindirizzata l'interfaccia utente. Questo parametro non può essere NULL.

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_ALREADY_EXISTS
 La destinazione specificata esiste già nell'elenco.
ERROR_INVALID_HANDLE
 L'handle di sessione non è valido o non è valido.
ERROR_INVALID_PARAMETER
 il puntatore lpdwSize o lpszDestination è NULL o lpObjectId non è un contenitore valido o dwType o dwOperation non è uno dei tre valori validi.
ERROR_NOT_ENOUGH_MEMORY
 Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_OBJECT_NOT_FOUND
 Il GUID specificato da lpObjectId non è il GUID di qualsiasi computer o oggetto di libreria nel database.
ERROR_SUCCESS
 La funzione ha avuto esito positivo.

Commenti

Una chiamata a SetNtmsUIOptions aggiunge o rimuove una destinazione per una determinata istanza determinata dai parametri lpObjectId e dwType .

  NTMS_UITYPE_INFO NTMS_UITYPE_REQ NTMS_UITYPE_ERR
Applicazione Visualizzare l'interfaccia utente dello stato dell'elemento di lavoro per gli elementi di lavoro generati da questa applicazione. Visualizzare l'interfaccia utente della richiesta dell'operatore per le richieste dell'operatore generate dalle azioni eseguite da questa applicazione. Non definito. Le applicazioni non possono causare questo tipo di evento di errore.
Libreria Visualizzare l'interfaccia utente dello stato dell'elemento di lavoro per gli elementi di lavoro associati a questa libreria. Visualizzare l'interfaccia utente per le richieste associate a questa libreria. Visualizzare l'interfaccia utente per gli errori associati a questa libreria.
Computer Visualizzare l'interfaccia utente informativo in questa istanza di RSM in esecuzione in questo computer. Visualizzare un'interfaccia utente di tipo richiesta in questa istanza di RSM. Visualizzare l'interfaccia utente del tipo di errore in questa istanza di RSM.
 

Si noti che i controlli di sicurezza vengono eseguiti quando si chiama SetNtmsUIOptions. Quando l'oggetto computer è specificato, è necessario avere accesso con l'autorizzazione per modificare il computer. Quando si modifica l'elemento dell'interfaccia utente di una libreria, è necessario avere accesso con l'autorizzazione per modificare l'oggetto libreria.

Si noti che non è presente alcun controllo delle stringhe di destinazione. Una chiamata a con un nome di destinazione che non è raggiungibile da un computer dal computer in cui SetNtmsUIOptions denominato restituisce esito positivo. Viene preso un puntatore a una stringa vuota per indicare il computer locale.

Nota

L'intestazione ntmsapi.h definisce SetNtmsUIOptions come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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

GetNtmsUIOptions

Funzioni di controllo della libreria