Funzione GetNtmsUIOptionsA (ntmsapi.h)

Articolo
02/29/2024

[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 dai parametri lpObjectId e 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 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 .

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

[out] lpszDestination

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

[in, out] lpdwBufSize

Dimensioni della stringa di destinazione, in TCHARs.

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	Le dimensioni del buffer specificate da lpdwSize sono troppo piccole per le destinazioni trovate. La funzione restituisce le dimensioni effettive in lpdwSize.
ERROR_INVALID_HANDLE	L'handle di sessione non è valido o non è valido.
ERROR_INVALID_PARAMETER	Il parametro lpdwSize o lpszDestination è NULL o lpObjectId non è un contenitore valido o 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 di libreria nel database.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

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

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

Funzioni di controllo della libreria

SetNtmsUIOptions

Condividi tramite