Fonction CoGetCallerTID (combaseapi.h)

Retourne un pointeur vers un DWORD qui contient l’ID d’appartement du thread de l’appelant.

Syntaxe

HRESULT CoGetCallerTID(
  [out] LPDWORD lpdwTID
);

Paramètres

[out] lpdwTID

Reçoit l’ID d’appartement du thread de l’appelant. Pour un appartement à thread unique (STA), il s’agit de l’ID de thread actuel. Pour un appartement multithread (MTA), la valeur est 0. Pour un appartement neutre (NA), la valeur est -1.

Valeur retournée

Cette fonction peut retourner les valeurs suivantes.

Remarques

Si l’appelant n’est pas en cours d’exécution sur le même ordinateur, cette fonction ne retourne pas l’ID d’appartement et la valeur de retour est S_FALSE.

Il n’est pas garanti que les informations retournées par cette API ne soient pas falsifiées. Par conséquent, n’utilisez pas l’ID retourné pour prendre des décisions de sécurité. L’ID ne peut être utilisé qu’à des fins de journalisation et de diagnostic.

Configuration requise