Compartir a través de

Función CoGetCallerTID (combaseapi.h)

  • Artículo

Devuelve un puntero a un DWORD que contiene el identificador de apartamento del subproceso del autor de la llamada.

Sintaxis

HRESULT CoGetCallerTID(
  [out] LPDWORD lpdwTID
);

Parámetros

[out] lpdwTID

Recibe el identificador de apartamento del subproceso del autor de la llamada. En el caso de un único contenedor de subprocesos (STA), este es el identificador de subproceso actual. Para un apartamento multiproceso (MTA), el valor es 0. Para un apartamento neutro (NA), el valor es -1.

Valor devuelto

Esta función puede devolver los valores siguientes.

Código devuelto Descripción
S_TRUE
 El identificador del subproceso del autor de la llamada se establece y el autor de la llamada está en el mismo proceso.
S_FALSE
 El identificador de subproceso del autor de la llamada se establece y el autor de la llamada está en un proceso diferente.
E_OUTOFMEMORY
 No se estableció el identificador del subproceso del autor de la llamada.

Comentarios

Si el autor de la llamada no se ejecuta en el mismo equipo, esta función no devuelve el identificador de apartamento y el valor devuelto es S_FALSE.

No hay ninguna garantía de que la información devuelta de esta API no se manipule, por lo que no use el identificador que se devuelve para tomar decisiones de seguridad. El identificador solo se puede usar con fines de registro y diagnóstico.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado combaseapi.h (incluya Objbase.h)
Library Ole32.lib
Archivo DLL Ole32.dll