CoGetCallerTID-Funktion (combaseapi.h)

Artikel
08/22/2023

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
S_TRUE	Die Thread-ID des Aufrufers ist festgelegt, und der Aufrufer befindet sich im gleichen Prozess.
S_FALSE	Die Thread-ID des Aufrufers ist festgelegt, und der Aufrufer befindet sich in einem anderen Prozess.
E_OUTOFMEMORY	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

Freigeben über