IDebugThread2::GetThreadProperties
Ruft die Eigenschaften ab, die diesen Thread beschreiben.
HRESULT GetThreadProperties (
THREADPROPERTY_FIELDS dwFields,
THREADPROPERTIES* ptp
);
int GetThreadProperties (
enum_THREADPROPERTY_FIELDS dwFields,
THREADPROPERTIES[] ptp
);
Parameter
dwFields
[in] Eine Kombination von Flags aus der THREADPROPERTY_FIELDS-Enumeration, mit der bestimmt wird, welche Felder von ptp gefüllt werden sollen.ptp
[in, out] Eine THREADPROPERTIES Struktur, die die Eigenschaften des Threads eingetragen wird.
Rückgabewert
Bei Erfolg gibt S_OKzurück. andernfalls gibt einen Fehlercode zurück.
Hinweise
Die Informationen, die von dieser Methode zurückgegeben werden, sind in der Regel im Fenster Debuggen Threads gezeigt.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie diese Methode für ein einfaches CProgram-Objekt implementiert, das die IDebugThread2-Schnittstelle implementiert.
HRESULT CProgram::GetThreadProperties(THREADPROPERTY_FIELDS dwFields,
THREADPROPERTIES *ptp)
{
HRESULT hr = E_FAIL;
// Check for valid argument.
if (ptp)
{
// Create an array of buffers at ptp the size of the
// THREADPROPERTIES structure and set all of the
// buffers at ptp to 0.
memset(ptp, 0, sizeof (THREADPROPERTIES));
// Check if there is a valid THREADPROPERTY_FIELDS and the TPF_ID flag is set.
if (dwFields & TPF_ID)
{
// Check for successful assignment of the current thread ID to
// the dwThreadId of the passed THREADPROPERTIES.
if (GetThreadId(&(ptp->dwThreadId)) == S_OK)
{
// Set the TPF_ID flag in the THREADPROPERTY_FIELDS enumerator
// of the passed THREADPROPERTIES.
ptp->dwFields |= TPF_ID;
}
}
hr = S_OK;
}
else
hr = E_INVALIDARG;
return hr;
}