Funzione GetNtmsUIOptionsA (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 GetNtmsUIOptions ottiene l'elenco dei nomi di computer a cui viene indirizzato il tipo specificato di interfaccia utente per l'oggetto specificato. Una chiamata a GetNtmsUIOptions restituisce l'elenco di destinazioni per l'istanza determinata dal lpObjectId e dai parametri dwType.

Se non sono presenti destinazioni nell'elenco per l'istanza specificata, la funzione restituisce ERROR_SUCCESS insieme a una lunghezza di elenco pari a zero.

Sintassi

DWORD GetNtmsUIOptionsA(
  [in]      HANDLE            hSession,
  [in]      const LPNTMS_GUID lpObjectId,
  [in]      DWORD             dwType,
  [out]     LPSTR             lpszDestination,
  [in, out] LPDWORD           lpdwBufSize
);

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 .

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

[out] lpszDestination

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

[in, out] lpdwBufSize

Dimensioni della stringa di destinazione, in TCHAR.

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_INSUFFICIENT_BUFFER	La dimensione del buffer specificata da lpdwSize è troppo piccola per le destinazioni trovate. La funzione restituisce le dimensioni effettive in lpdwSize.
ERROR_INVALID_HANDLE	L'handle di sessione è mancante o non è valido.
ERROR_INVALID_PARAMETER	Il parametro lpdwSize o lpszDestination è NULLo lpObjectId non è un contenitore valido oppure dwType 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 GetNtmsUIOptions restituisce un elenco di destinazioni 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.	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.

Nota

L'intestazione ntmsapi.h definisce GetNtmsUIOptions 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

Funzioni di controllo della libreria

SetNtmsUIOptions

Condividi tramite