QueryActCtxW-Funktion (winbase.h)

Die QueryActCtxW-Funktion fragt den Aktivierungskontext ab.

Syntax

BOOL QueryActCtxW(
  [in]            DWORD  dwFlags,
  [in]            HANDLE hActCtx,
  [in, optional]  PVOID  pvSubInstance,
  [in]            ULONG  ulInfoClass,
  [out]           PVOID  pvBuffer,
  [in, optional]  SIZE_T cbBuffer,
  [out, optional] SIZE_T *pcbWrittenOrRequired
);

Parameter

[in] dwFlags

Dieser Parameter sollte auf eines der folgenden Flagbits festgelegt werden.

[in] hActCtx

Behandeln Sie den aktivierungskontext, der abgefragt wird.

[in, optional] pvSubInstance

Index der Assembly oder Assembly- und Dateikombination im Aktivierungskontext. Die Bedeutung von pvSubInstance hängt von der Option ab, die durch den Wert des ulInfoClass-Parameters angegeben wird.

Dieser Parameter kann NULL sein.

[in] ulInfoClass

Dieser Parameter darf nur die Werte enthalten, die in der folgenden Tabelle angezeigt werden.

[out] pvBuffer

Zeiger auf einen Puffer, der die zurückgegebenen Informationen enthält. Dieser Parameter ist optional. Wenn pvBufferNULL ist, muss cbBuffer null sein. Wenn die Größe des Puffers, auf den von pvBuffer verwiesen wird, zu klein ist, gibt QueryActCtxW ERROR_INSUFFICIENT_BUFFER zurück, und es werden keine Daten in den Puffer geschrieben. Die Methode, mit der Sie die erforderliche Größe des Puffers ermitteln können, finden Sie im Abschnitt Hinweise.

[in, optional] cbBuffer

Größe des Puffers in Bytes, auf die von pvBuffer verwiesen wird. Dieser Parameter ist optional.

[out, optional] pcbWrittenOrRequired

Anzahl der geschriebenen oder erforderlichen Bytes. Der Parameter pcbWrittenOrRequired kann nur NULL sein, wenn pvBufferNULL ist. Wenn pcbWrittenOrRequired nicht NULL ist, wird es mit der Anzahl von Bytes gefüllt, die zum Speichern des zurückgegebenen Puffers erforderlich sind.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Diese Funktion legt Fehler fest, die durch Aufrufen von GetLastError abgerufen werden können. Ein Beispiel finden Sie unter Abrufen des Last-Error Codes. Eine vollständige Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Der Parameter cbBuffer gibt die Größe des Puffers in Bytes an, auf den von pvBuffer verwiesen wird. Wenn pvBufferNULL ist, muss cbBuffer 0 sein. Der Parameter pcbWrittenOrRequired kann nur NULL sein, wenn pvBufferNULL ist. Wenn pcbWrittenOrRequired bei der Rückgabe nicht NULL ist, wird es mit der Anzahl von Bytes gefüllt, die zum Speichern der zurückgegebenen Informationen erforderlich sind. Wenn die zurückgegebenen Informationsdaten größer als der bereitgestellte Puffer sind, gibt QueryActCtxW ERROR_INSUFFICIENT_BUFFER zurück, und es werden keine Daten in den Puffer geschrieben, auf den von pvBuffer verwiesen wird.

Das folgende Beispiel zeigt die Methode zum Aufrufen zuerst mit einem kleinen Puffer und dann zum Abrufen, wenn der Puffer zu klein ist.

SIZE_T cbRequired;
PVOID pvData = NULL;
SIZE_T cbAvailable = 0;

if (!QueryActCtxW(..., pvData, cbAvailable, &cbRequired) && (GetLastError()== ERROR_INSUFFICIENT_BUFFER))
{
    // Allocate enough space to store the returned buffer, fail if too small
    if (NULL == (pvData = HeapAlloc(GetProcessHeap(), 0, cbRequired)))
    {
        SetLastError(ERROR_NOT_ENOUGH_MEMORY);
        return FALSE;
    }
    cbAvailable = cbRequired;
    // Try again, this should succeed.
    if (QueryActCtxW(..., pvData, cbAvailable, &cbRequired))
    {
        // Use the returned data in pvData
    }
    HeapFree(GetProcessHeap(), 0, pvData);
    pvData = NULL;
}

Anforderungen