Condividi tramite

Funzione SetNtmsUIOptionsW (ntmsapi.h)

  • Articolo

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

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

Sintassi

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

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] lpObjectId

Identificatore univoco dell'oggetto di cui viene reindirizzato 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'eject) o un computer (tutte le interfacce utente relative al computer).

Per specificare il contenitore del computer, impostare il puntatore lpObjectId in modo che punti a un buffer con il GUID dell'oggetto computer di Gestione archiviazione rimovibile. Per specificare una particolare libreria impostarla in modo che punti 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 valore impostato 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 inserire nuovi supporti.
NTMS_UITYPE_ERR
 Messaggi dell'interfaccia utente che forniscono informazioni sull'errore. Queste includono le richieste degli operatori correlate alla notifica degli errori. Ad esempio, una richiesta di pulire l'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
 Deselezionare tutte le destinazioni dall'elenco. Non viene generata alcuna interfaccia utente per l'oggetto. In questo caso, l'argomento di destinazione viene ignorato.

[out] lpszDestination

Multi-stringa che restituisce i nomi dei computer a cui viene reindirizzato 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 è mancante o non è valido.
ERROR_INVALID_PARAMETER
 lpdwSize o lpszDestination puntatore è nullo lpObjectId non è un contenitore valido oppure 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 libreria nel database.
ERROR_SUCCESS
 La funzione ha avuto esito positivo.

Osservazioni

Una chiamata a SetNtmsUIOptions aggiunge o rimuove una destinazione per una determinata istanza determinata dal lpObjectId e dai parametri 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. Interfaccia utente della richiesta dell'operatore di visualizzazione per le richieste degli operatori generate da azioni eseguite da questa applicazione. Indefinito. Le applicazioni non possono causare questo tipo di evento di errore.
Biblioteca Visualizzare l'interfaccia utente dello stato dell'elemento di lavoro per gli elementi di lavoro associati a questa raccolta. 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 informativa 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 di tipo errore in questa istanza di RSM.
 

Si noti che i controlli di sicurezza vengono eseguiti quando si chiama SetNtmsUIOptions. Quando si specifica l'oggetto computer, è 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 è un computer raggiungibile dal computer in cui SetNtmsUIOptions chiamata restituisce l'esito positivo. Un puntatore a una stringa vuota viene impiegato 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 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

Vedere anche

GetNtmsUIOptions

Funzioni di controllo della libreria