SetNtmsUIOptionsA-Funktion (ntmsapi.h)
[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]
Die SetNtmsUIOptions-Funktion ändert die Liste der Computernamen, an die der angegebene Benutzeroberflächentyp für das angegebene Objekt weitergeleitet wird.
Syntax
DWORD SetNtmsUIOptionsA(
[in] HANDLE hSession,
[in] const LPNTMS_GUID lpObjectId,
[in] DWORD dwType,
[in] DWORD dwOperation,
[out] LPCSTR lpszDestination
);
Parameter
[in] hSession
Handle für die von der OpenNtmsSession-Funktion zurückgegebene Sitzung.
[in] lpObjectId
Eindeutiger Bezeichner des Objekts, dessen Benutzeroberfläche umgeleitet wird. Das Objekt muss ein Container sein, der eine Quelle für Ereignisse sein kann. Das Objekt kann entweder eine Anwendung (eine von der Anwendung ausgelöste Einbindungsanforderung), eine Bibliothek (eine Tür öffnende Anforderung als Reaktion auf einen Auswurf) oder ein Computer (alle Benutzeroberfläche für den Computer) sein.
Legen Sie zum Angeben des Computercontainers den zeiger lpObjectId so fest, dass er mit der Computerobjekt-GUID des Wechseldatenträger-Managers auf einen Puffer zeigt. Um eine bestimmte Bibliothek anzugeben, legen Sie sie so fest, dass sie mit der GUID der Bibliothek auf einen Puffer verweist. Um eine Anwendung anzugeben, übergeben Sie einen NULL-Zeiger . Die Identität der Anwendung wird durch die sitzung bestimmt, die in hSession verwendet wird. Beachten Sie, dass für eine Anwendung mehrere Sitzungen gleichzeitig geöffnet werden können. In diesem Fall gilt der Wertsatz nur für die hSession-Sitzung . Im Fall einer Bibliothek oder eines Computers instance, bleiben die Einstellungen so lange erhalten, bis sie explizit geändert wurden. Anwendungszeilen werden gelöscht, wenn die Sitzung geschlossen wird.
[in] dwType
Dieser Parameter kann einen der folgenden Werte aufweisen.
[in] dwOperation
Dieser Parameter kann einen der folgenden Werte aufweisen.
[out] lpszDestination
Mehrere Zeichenfolgen, die die Namen der Computer zurückgibt, an die die Benutzeroberfläche umgeleitet wird. Dieser Parameter darf nicht NULL sein.
Rückgabewert
Diese Funktion gibt einen der folgenden Werte zurück.
| Wert | Bedeutung |
|---|---|
|
Der Zugriff auf ein oder mehrere RSM-Objekte wird verweigert. |
|
Das angegebene Ziel ist bereits in der Liste vorhanden. |
|
Das Sitzungshandle fehlt oder ist ungültig. |
|
der Zeiger lpdwSize oder lpszDestination ist NULL, oder lpObjectId ist kein gültiger Container, oder dwType oder dwOperation ist keiner der drei gültigen Werte. |
|
Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten. |
|
Die von lpObjectId angegebene GUID ist nicht die GUID eines Computers oder Bibliotheksobjekts in der Datenbank. |
|
Die Funktion war erfolgreich. |
Hinweise
Bei einem Aufruf von SetNtmsUIOptions wird ein Ziel für eine bestimmte instance hinzugefügt oder entfernt, die durch die Parameter lpObjectId und dwType bestimmt wird.
| NTMS_UITYPE_INFO | NTMS_UITYPE_REQ | NTMS_UITYPE_ERR | |
|---|---|---|---|
| Anwendung | Anzeigen des Arbeitselementstatus für von dieser Anwendung generierte Arbeitselemente | Benutzeroberfläche der Operatoranforderung für Operatoranforderungen anzeigen, die von aktionen dieser Anwendung generiert werden. | Nicht definiert. Anwendungen können diese Art von Fehlerereignis nicht verursachen. |
| Bibliothek | Anzeigen des Arbeitselementstatus für Arbeitselemente, die dieser Bibliothek zugeordnet sind. | Anzeigen der Benutzeroberfläche für Anforderungen, die dieser Bibliothek zugeordnet sind. | Anzeigen der Benutzeroberfläche für Fehler im Zusammenhang mit dieser Bibliothek. |
| Computer | Anzeigen der Benutzeroberfläche für Informationen in dieser instance von RSM, die auf diesem Computer ausgeführt wird. | Zeigen Sie eine Anforderungsbenutzeroberfläche in diesem instance von RSM an. | Anzeigen der Benutzeroberfläche des Fehlertyps in diesem instance von RSM. |
Beachten Sie, dass Sicherheitsüberprüfungen ausgeführt werden, wenn SetNtmsUIOptions aufgerufen wird. Wenn das Computerobjekt angegeben wird, müssen Sie zugriff mit der Berechtigung zum Ändern des Computers haben. Wenn Sie das UI-Element einer Bibliothek ändern, müssen Sie zugriff mit der Berechtigung zum Ändern des Bibliotheksobjekts haben.
Beachten Sie, dass keine Überprüfung der Zielzeichenfolgen erfolgt. Ein Aufruf von mit einem Zielnamen, der kein Computer ist, der von dem Computer aus erreichbar ist, auf dem SetNtmsUIOptions aufgerufen wird, gibt erfolgreich zurück. Ein Zeiger auf eine leere Zeichenfolge wird für den lokalen Computer verwendet.
Hinweis
Der ntmsapi.h-Header definiert SetNtmsUIOptions als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ntmsapi.h |
| Bibliothek | Ntmsapi.lib |
| DLL | Ntmsapi.dll |