CoGetCallerTID-Funktion (combaseapi.h)

  • Artikel

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