Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gibt einen Zeiger auf ein DWORD zurück, das die Apartment-ID des Aufrufersthreads enthält.
Syntax
HRESULT CoGetCallerTID(
[out] LPDWORD lpdwTID
);
Parameter
[out] lpdwTID
Empfängt die Apartment-ID des Aufrufersthreads. Für ein Single Threaded Apartment (STA) ist dies die aktuelle Thread-ID. Für ein Multithread-Apartment (MTA) ist der Wert 0. Für eine neutrale Wohnung (NA) ist der Wert -1.
Rückgabewert
Diese Funktion kann die folgenden Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Thread-ID des Aufrufers ist festgelegt, und der Aufrufer befindet sich im gleichen Prozess. |
|
Die Thread-ID des Aufrufers ist festgelegt, und der Aufrufer befindet sich in einem anderen Prozess. |
|
Die Thread-ID des Aufrufers wurde nicht festgelegt. |
Hinweise
Wenn der Aufrufer nicht auf demselben Computer ausgeführt wird, gibt diese Funktion die Apartment-ID nicht zurück, und der Rückgabewert ist S_FALSE.
Es gibt keine Garantie, dass die von dieser API zurückgegebenen Informationen nicht manipuliert werden. Verwenden Sie daher nicht die zurückgegebene ID, um Sicherheitsentscheidungen zu treffen. Die ID kann nur für Protokollierungs- und Diagnosezwecke verwendet werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | combaseapi.h (include Objbase.h) |
| Bibliothek | Ole32.lib |
| DLL | Ole32.dll |